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 方法检索了有效值列表。