VideoCategories: list

傳回可以與 YouTube 影片建立關聯的類別清單。

配額影響：呼叫這個方法的配額為 1 個單位。

常見用途

要求

HTTP 要求

GET https://www.googleapis.com/youtube/v3/videoCategories

參數

下表列出此查詢支援的參數。這裡列出的參數全都是查詢參數。

參數
必要參數
part string
part 參數會指定 API 回應會包含的 videoCategory 資源屬性。將參數值設為 snippet。
篩選器 (請僅指定下列其中一個參數)
id string
id 參數會針對要擷取的資源，指定以半形逗號分隔的影片類別 ID 清單。
regionCode string
regionCode 參數會指示 API 傳回指定國家/地區可用的影片類別清單。參數值採用 ISO 3166-1 alpha-2 國家/地區代碼。
選用參數
hl string
hl 參數會指定 API 回應中的文字值應使用的語言。預設值為 en_US。

要求主體

呼叫此方法時，不要提供要求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "youtube#videoCategoryListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    videoCategory resource
  ]
}

屬性

下表定義了這項資源中顯示的屬性：

屬性
kind string
識別 API 資源的類型。值為 youtube#videoCategoryListResponse。
etag etag
這項資源的 Etag。
nextPageToken string
可做為 pageToken 參數值的權杖，用於擷取結果集中的下一頁。
prevPageToken string
可做為 pageToken 參數值的權杖，擷取結果集中的上一頁。
pageInfo object
pageInfo 物件會封裝結果集的分頁資訊。
pageInfo.totalResults integer
結果集的結果總數。
pageInfo.resultsPerPage integer
API 回應中包含的結果數量。
items[] list
可與 YouTube 影片建立關聯的影片類別清單。在此地圖中，影片類別 ID 為地圖鍵，而其值是對應的 videoCategory 資源。

錯誤

下表列出 API 回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息的說明文件。

錯誤類型 錯誤詳細資料 說明
notFound (404) videoCategoryNotFound 找不到 id 參數識別的影片類別。使用 videoCategories.list 方法擷取有效值的清單。

試試看！

使用 APIs Explorer 呼叫這個 API 並查看 API 要求和回應。