我们正在更新 Data API，以便与 YouTube 统计 Shorts 短视频观看次数的方式保持一致。
了解详情
PlaylistImages: update
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
修改播放列表图片。
配额影响：调用此方法将产生 50 个单位的配额费用。
请求
HTTP 请求
PUT https://www.googleapis.com/youtube/v3/playlistImages
授权
此请求需要获得以下至少一个范围的授权（详细了解身份验证和授权）。
| 范围 |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
参数
下表列出了此查询支持的参数。列出的所有参数均为查询参数。
| 参数 |
| 必需参数 |
part |
string
part 参数指定了一个
包含一个或多个 playlistImage 资源的逗号分隔列表
API 响应将包含的属性。
如果参数
表示包含子属性的属性，子属性
会包含在响应中。
|
| 可选参数 |
onBehalfOfContentOwner |
string
注意：onBehalfOfContentOwner 参数仅适用于 YouTube 内容合作伙伴，且只能用于获得适当授权的请求。
此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。它让与内容所有者相关联的用户只需进行身份验证一次，即可访问和管理内容所有者的所有视频和频道数据，而无需为每个频道提供身份验证凭据。
当该参数存在时，其值用于标识内容所有者，请求的授权凭据则用于识别有权代表内容所有者执行操作的 YouTube 用户。在 YouTube 创作者工作室设置中，用户进行身份验证时所用的账号必须与指定的内容所有者相关联。 |
请求正文
在请求正文中提供 playlistImages 资源。
对于该资源：
-
您必须为以下属性指定一个值：
snippet.playlistIdsnippet.type
-
您可以为以下属性设置值：
snippet.widthsnippet.height
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2024-08-16。
[null,null,["最后更新时间 (UTC)：2024-08-16。"],[[["\u003cp\u003eThis method allows modification of a playlist image via the YouTube API.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing this method incurs a quota cost of 50 units per call.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required, with scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/youtube\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.force-ssl\u003c/code\u003e being necessary.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter is required, while \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e is an optional parameter intended for YouTube content partners.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eplaylistImages\u003c/code\u003e resource with specified values for \u003ccode\u003esnippet.playlistId\u003c/code\u003e and \u003ccode\u003esnippet.type\u003c/code\u003e, and can optionally include \u003ccode\u003esnippet.width\u003c/code\u003e and \u003ccode\u003esnippet.height\u003c/code\u003e.\u003c/p\u003e\n"]]],["This outlines how to modify a playlist image via the YouTube API. A `PUT` request is sent to `playlistImages`, costing 50 quota units. Authorization is required, utilizing scopes like `youtubepartner`. The request needs the `part` parameter and can optionally include `onBehalfOfContentOwner`. The request body requires `snippet.playlistId` and `snippet.type` properties and can optionally have `snippet.width` and `snippet.height` set. A successful request returns a `playlistItem` resource.\n"],null,["# PlaylistImages: update\n\nModifies a playlist image.\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/youtube/v3/playlistImages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/guides/authentication)).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter specifies a comma-separated list of one or more `playlistImage` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** The **onBehalfOfContentOwner** parameter is intended exclusively for YouTube content partners and can only be used in a properly [authorized request](/youtube/v3/guides/authentication). This parameter is designed for YouTube content partners that own and manage many different YouTube channels. It enables users affiliated with the content owner to authenticate once and then be able to access and manage all of the content owner's video and channel data, without having to provide authentication credentials for each individual channel. When the parameter is present, its value identifies a content owner, and the request's authorization credentials identify a YouTube user who is authorized to act on behalf of that content owner. The account that the user authenticates with must be [linked to the specified content owner](https://support.google.com/youtube/answer/4524878) in the YouTube Creator Studio settings. |\n\n### Request body\n\nProvide a [playlistImages resource](/youtube/v3/docs/playlistImages#resource) in the request body.\n\nFor that resource:\n\n- You must specify a value for these properties:\n\n - `snippet.playlistId`\n - `snippet.type`\n- You can set values for these properties:\n\n - `snippet.width`\n - `snippet.height`\n\nResponse\n--------\n\nIf successful, this method returns a [playlistItem resource](/youtube/v3/docs/playlistImages#resource) in the response body."]]
