我們正在更新 Data API,以符合 YouTube 計算 Shorts 觀看次數的方式。
瞭解詳情
PlaylistImages
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
playlistImage
資源會指明與播放清單相關聯的縮圖。
方法
這個 API 支援 playlistImages
資源的下列方法:
- list
- 傳回符合 API 要求參數的播放清單圖片集合。
立即試用。
- 插入
- 為播放清單新增縮圖。
立即試用。
- 更新
- 更新現有播放清單的縮圖。
立即試用。
- 刪除
- 刪除播放清單縮圖。
立即試用。
屬性
下表定義這個資源中顯示的屬性:
屬性 |
kind |
string
識別 API 資源的類型。值為 youtube#playlistImage 。 |
id |
string
YouTube 用來識別播放清單圖片的專屬 ID。 |
snippet |
object
snippet 物件包含播放清單圖片的基本詳細資料,例如類型和尺寸。 |
snippet.playlistId |
string
與這張圖片相關聯的播放清單 ID。 |
snippet.type |
string
圖片類型。
|
snippet.width |
string
圖片寬度。 |
snippet.height |
string
圖片的高度。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[null,null,["上次更新時間:2025-08-21 (世界標準時間)。"],[[["\u003cp\u003eA playlistImage resource in the YouTube API represents the thumbnail image associated with a specific playlist.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides methods to list, insert, update, and delete playlist images, allowing for comprehensive management of playlist thumbnails.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eplaylistImages\u003c/code\u003e resource contains properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, and \u003ccode\u003esnippet\u003c/code\u003e, with the \u003ccode\u003esnippet\u003c/code\u003e object detailing the associated playlist's ID, image type, width, and height.\u003c/p\u003e\n"],["\u003cp\u003eThe API's \u003ccode\u003eplaylistImages\u003c/code\u003e resource structure is in JSON format, and the value of \u003ccode\u003ekind\u003c/code\u003e is always \u003ccode\u003eyoutube#playlistImage\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `playlistImage` resource represents a playlist's thumbnail. The API provides methods to interact with these images: `list` retrieves images, `insert` adds an image, `update` modifies an existing image, and `delete` removes an image. Each `playlistImage` resource contains an `id`, `kind` which will always be `youtube#playlistImage`, and a `snippet` with details like `playlistId`, `type`, `width`, and `height` of the image.\n"],null,["# PlaylistImages\n\nA **playlistImage** resource identifies\nthe thumbnail image associated with a playlist.\n\nMethods\n-------\n\nThe API supports the following methods for `playlistImages` resources:\n\n[list](/youtube/v3/docs/playlistImages/list)\n: Returns a collection of playlist images that match the API request parameters.\n [Try it now](/youtube/v3/docs/playlistImages/list#usage).\n\n[insert](/youtube/v3/docs/playlistImages/insert)\n: Adds a thumbail image to a playlist.\n [Try it now](/youtube/v3/docs/playlistImages/insert#usage).\n\n[update](/youtube/v3/docs/playlistImages/update)\n: Updates the thumbnail image for an existing playlist.\n [Try it now](/youtube/v3/docs/playlistImages/update#usage).\n\n[delete](/youtube/v3/docs/playlistImages/delete)\n: Deletes a playlist thumbnail image.\n [Try it now](/youtube/v3/docs/playlistImages/delete#usage).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `playlistImages` resource: \n\n```carbon\n{\n \"#kind\": \"youtube#playlistImage\",\n \"#id\": string,\n \"#snippet\": {\n \"#snippet.playlistId\": string,\n \"#snippet.type\": string,\n \"#snippet.width\": string,\n \"#snippet.height\": 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#playlistImage`. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the playlist image. |\n| `snippet` | `object` The `snippet` object contains basic details about the playlist image, such as its type and dimensions. |\n| snippet.`playlistId` | `string` The playlist ID of the playlist this image is associated with. |\n| snippet.`type` | `string` The image type. |\n| snippet.`width` | `string` The image's width. |\n| snippet.`height` | `string` The images's height. |"]]