我們正在更新 Data API,以符合 YouTube 計算 Shorts 觀看次數的方式。
瞭解詳情
VideoCategories
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
videoCategory
資源會指明已與上傳影片建立關聯或可能建立關聯的類別。
方法
這個 API 支援 videoCategories
資源的下列方法:
- list
- 傳回可與 YouTube 影片建立關聯的類別清單。
立即試用。
屬性
下表定義這個資源中顯示的屬性:
屬性 |
kind |
string
識別 API 資源的類型。值為 youtube#videoCategory 。 |
etag |
etag
這項資源的 Etag。 |
id |
string
YouTube 用來識別影片類別的專屬 ID。 |
snippet |
object
snippet 物件包含影片類別的基本詳細資料,包括標題。 |
snippet.channelId |
string
建立影片類別的 YouTube 頻道。 |
snippet.title |
string
影片類別的標題。 |
snippet.assignable |
boolean
指出影片是否可與類別建立關聯。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[null,null,["上次更新時間:2025-08-21 (世界標準時間)。"],[[["\u003cp\u003eA \u003ccode\u003evideoCategory\u003c/code\u003e resource in the YouTube API defines a category that can be associated with uploaded videos.\u003c/p\u003e\n"],["\u003cp\u003eThe API's \u003ccode\u003evideoCategories\u003c/code\u003e list method returns a list of categories applicable to YouTube videos.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003evideoCategory\u003c/code\u003e resource includes an ID, a title, and information about whether the category is assignable to videos.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esnippet\u003c/code\u003e section within a \u003ccode\u003evideoCategory\u003c/code\u003e resource provides basic details such as the channel that created it and its title.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ekind\u003c/code\u003e property of the resource is always a string that identifies the resource type as \u003ccode\u003eyoutube#videoCategory\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `videoCategory` resource identifies video categories for YouTube uploads. The API's `videoCategories.list` method retrieves a list of these categories. Each category is represented with a unique ID, title, and the channel ID that created it. The resource also includes an `assignable` property that indicates if videos can be linked to the specific category. The resource type is identified as `youtube#videoCategory`.\n"],null,["# VideoCategories\n\nA **videoCategory** resource identifies a category that has been or could be associated with uploaded videos.\n\nMethods\n-------\n\nThe API supports the following methods for `videoCategories` resources:\n\n[list](/youtube/v3/docs/videoCategories/list)\n: Returns a list of categories that can be associated with YouTube videos.\n [Try it now](/youtube/v3/docs/videoCategories/list#usage).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `videoCategories` resource: \n\n```verilog\n{\n \"#kind\": \"youtube#videoCategory\",\n \"#etag\": etag,\n \"#id\": string,\n \"#snippet\": {\n \"#snippet.channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"#snippet.title\": string,\n \"#snippet.assignable\": boolean\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#videoCategory`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the video category. |\n| `snippet` | `object` The `snippet` object contains basic details about the video category, including its title. |\n| snippet.`channelId` | `string` The YouTube channel that created the video category. |\n| snippet.`title` | `string` The video category's title. |\n| snippet.`assignable` | `boolean` Indicates whether videos can be associated with the category. |"]]