我们正在更新 Data API,以便与 YouTube 统计 Shorts 短视频观看次数的方式保持一致。
了解详情
GuideCategories
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
注意:这是一条废弃公告。
自 2020 年 9 月 9 日起,guideCategories
资源和 guideCategories.list
方法已被废弃。
guideCategory
资源用于标识 YouTube 根据频道内容或其他指标(例如频道的热门程度)算法分配的类别。此列表与视频类别类似,不同之处在于视频上传者可以指定视频类别,但只有 YouTube 可以指定频道类别。
方法
对于 guideCategories
资源,该 API 支持以下方法:
- list
- 返回可与 YouTube 频道相关联的类别列表。
立即试用。
资源表示法
以下 JSON 结构显示了 guideCategories
资源的格式:
{
"kind": "youtube#guideCategory",
"etag": etag,
"id": string,
"snippet": {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"title": string
}
}
属性
下表定义了此资源中显示的属性:
属性 |
kind |
string
标识 API 资源的类型。该值将为 youtube#guideCategory 。 |
etag |
etag
此资源的 ETag。 |
id |
string
YouTube 用于唯一标识导视类别的 ID。 |
snippet |
object
snippet 对象包含有关类别的基本详细信息,例如其标题。 |
snippet.channelId |
string
此 ID 是 YouTube 用来唯一标识发布导视类别的频道。 |
snippet.title |
string
类别的标题。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\u003cp\u003eThe \u003ccode\u003eguideCategories\u003c/code\u003e resource and \u003ccode\u003eguideCategories.list\u003c/code\u003e method were deprecated on September 9, 2020.\u003c/p\u003e\n"],["\u003cp\u003eA guide category is a classification assigned by YouTube to a channel based on its content or other indicators.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eguideCategories.list\u003c/code\u003e method provided a list of categories applicable to YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eguideCategory\u003c/code\u003e resource contains an ID, a snippet with basic details like a title, and other metadata such as the category's etag.\u003c/p\u003e\n"],["\u003cp\u003eUnlike video categories that are assigned by uploaders, channel categories are exclusively assigned by YouTube.\u003c/p\u003e\n"]]],["The `guideCategories` resource and its `list` method were deprecated on September 9, 2020. A `guideCategory` represents a YouTube-assigned category for a channel. The `list` method previously returned categories associated with YouTube channels. The resource's JSON structure included `kind`, `etag`, `id`, and a `snippet` object with `channelId` and `title` properties. Only YouTube could assign these categories, unlike video categories, which could be assigned by the uploader.\n"],null,["# GuideCategories\n\n**Note:** This is a deprecation announcement. \n\nThe `guideCategories` resource and the `guideCategories.list` method have both been deprecated as of September 9, 2020.\nA **guideCategory** resource identifies a category that YouTube algorithmically assigns based on a channel's content or other indicators, such as the channel's popularity. The list is similar to [video categories](/youtube/v3/docs/videoCategories), with the difference being that a video's uploader can assign a video category but only YouTube can assign a channel category.\n\nMethods\n-------\n\nThe API supports the following methods for `guideCategories` resources:\n\n[list](/youtube/v3/docs/guideCategories/list)\n: Returns a list of categories that can be associated with YouTube channels.\n [Try it now](/youtube/v3/docs/guideCategories/list#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `guideCategories` resource: \n\n```text\n{\n \"kind\": \"youtube#guideCategory\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"title\": string\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|---------------------|---------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#guideCategory`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the guide category. |\n| `snippet` | `object` The `snippet` object contains basic details about the category, such as its title. |\n| snippet.`channelId` | `string` The ID that YouTube uses to uniquely identify the channel publishing the guide category. |\n| snippet.`title` | `string` The category's title. |"]]