我们正在更新 Data API,以便与 YouTube 统计 Shorts 短视频观看次数的方式保持一致。
了解详情
PlaylistImages
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
playlistImage
资源用于标识与播放列表相关联的缩略图。
属性
下表定义了此资源中显示的属性:
属性 |
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
图片的高度。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):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. |"]]