我們正在更新 Data API,以符合 YouTube 計算 Shorts 觀看次數的方式。
瞭解詳情 GuideCategories
透過集合功能整理內容 你可以依據偏好儲存及分類內容。
注意:這是淘汰功能的公告。
guideCategories
資源和 guideCategories.list
方法已於 2020 年 9 月 9 日淘汰。
guideCategory
資源會識別 YouTube 根據頻道內容或其他指標 (例如頻道的熱門程度) 指派的類別。這份清單與影片類別類似,差別在於影片的上傳者可以指派影片類別,但只有 YouTube 可以指派頻道類別。
方法
API 支援下列 guideCategories
資源方法:
- 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 YouTube 用來識別發布指南類別的頻道專屬 ID。 |
snippet.title | string 類別標題。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間: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,["**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\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\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\nProperties\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. |"]]