我们正在更新 Data API,以便与 YouTube 统计 Shorts 短视频观看次数的方式保持一致。
了解详情
PlaylistImages: delete
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
删除播放列表图片。
配额影响:调用此方法将产生 50 个单位的配额费用。
请求
HTTP 请求
DELETE 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 |
参数
下表列出了此查询支持的参数。列出的所有参数均为查询参数。
参数 |
必需参数 |
id |
string
id 参数用于指定要删除的播放列表图片的 YouTube 播放列表图片 ID。在 playlistImages 资源中,id 属性指定播放列表图片的 ID。 |
可选参数 |
onBehalfOfContentOwner |
string
注意:onBehalfOfContentOwner 参数仅适用于 YouTube 内容合作伙伴,且只能用于获得适当授权的请求。
此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。它使与内容所有者相关联的用户只需进行身份验证一次,即可访问和管理内容所有者的所有视频和频道数据,而无需为每个频道提供身份验证凭据。
当该参数存在时,其值用于标识内容所有者,请求的授权凭据则用于识别有权代表内容所有者执行操作的 YouTube 用户。在 YouTube 创作者工作室设置中,用户进行身份验证时所用的账号必须与指定的内容所有者相关联。 |
响应
如果成功,此方法将返回 HTTP 204
响应代码 (No Content
)。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-16。
[null,null,["最后更新时间 (UTC):2024-08-16。"],[[["\u003cp\u003eThis method allows for the deletion of a playlist image using the YouTube Data API.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a playlist image requires authorization with one of the specified scopes, including \u003ccode\u003eyoutubepartner\u003c/code\u003e, \u003ccode\u003eyoutube\u003c/code\u003e, or \u003ccode\u003eyoutube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eid\u003c/code\u003e parameter is mandatory and specifies the unique ID of the playlist image to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method has a quota cost of 50 units per request.\u003c/p\u003e\n"],["\u003cp\u003eContent partners managing multiple channels can use the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter to manage their data.\u003c/p\u003e\n"]]],["This method deletes a specific playlist image on YouTube, identified by its `id`. The request is made via a `DELETE` HTTP request to the `/playlistImages` endpoint. Authorization is required, using one of the specified scopes. A `quota cost` of 50 units is associated with each call. An optional parameter, `onBehalfOfContentOwner`, allows content partners to manage data across multiple channels. Upon successful deletion, a `204` response code is returned. No request body is needed.\n"],null,["# PlaylistImages: delete\n\nDeletes 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```\nDELETE 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| `id` | `string` The **id** parameter specifies the YouTube playlist image ID for the playlist image that is being deleted. In a `playlistImages` resource, the `id` property specifies the playlist image's ID. |\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\nDo not provide a request body when calling this method.\n\nResponse\n--------\n\nIf successful, this method returns an HTTP `204` response code (`No Content`)."]]