我们正在更新 Data API，以便与 YouTube 统计 Shorts 短视频观看次数的方式保持一致。
了解详情
PlaylistItems: delete
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
删除播放列表项。
配额影响：对此方法的调用会产生 50 个单位的配额费用。
常见使用场景
请求
HTTP 请求
DELETE https://www.googleapis.com/youtube/v3/playlistItems
授权
此请求需要获得以下至少一个范围的授权。如需详细了解身份验证和授权，请参阅实现 OAuth 2.0 授权。
| 范围 |
|---|
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。在 playlistItem 资源中，id 属性用于指定播放列表项的 ID。 |
| 可选参数 |
onBehalfOfContentOwner |
string
注意：onBehalfOfContentOwner 参数仅供 YouTube 内容合作伙伴使用，只能在经过适当授权的请求中使用。
此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。借助此参数，与内容所有者关联的用户只需进行一次身份验证，即可访问和管理内容所有者的所有视频和频道数据，而无需为每个频道分别提供身份验证凭据。
如果存在此参数，其值会标识内容所有者，而请求的授权凭据会标识获授权代表该内容所有者行事的 YouTube 用户。用户进行身份验证时使用的账号必须在 YouTube 创作者工作室设置中与指定的内容所有者相关联。 |
响应
如果成功，此方法将返回 HTTP 204 No Content 状态代码。
错误
下表列出了该 API 在响应对此方法的调用时可能会返回的错误消息。如需了解详情，请参阅 YouTube Data API - 错误。
| 错误类型 |
错误详情 |
说明 |
forbidden (403) |
playlistItemsNotAccessible |
请求未获得正确授权，无法删除指定的播放列表项。 |
notFound (404) |
playlistItemNotFound |
找不到使用请求的 id 参数标识的播放列表项。 |
invalidValue (400) |
playlistOperationUnsupported |
该 API 不支持从指定播放列表中删除视频。例如，您无法从“上传的视频”播放列表中删除视频。 |
试试看！
使用 APIs Explorer 调用此 API，并查看 API 请求和响应。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2024-11-19。
[null,null,["最后更新时间 (UTC)：2024-11-19。"],[],[],null,["# PlaylistItems: delete\n\nDeletes a playlist item.\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nCommon use cases\n----------------\n\nThe list below shows common use cases for this method. Hover over a use case to see its description, or click on a use case to load sample parameter values in the APIs Explorer. You can open the [fullscreen APIs Explorer](#) to see code samples that dynamically update to reflect the parameter values entered in the Explorer.\n\nThe table below shows common use cases for this method. You can click on a use case name to load sample parameter values in the APIs Explorer. Or you can see code samples for a use case in the fullscreen APIs Explorer by clicking on the code icon below a use case name. In the fullscreen UI, you can update parameter and property values and the code samples will dynamically update to reflect the values you enter. \nThis method has one common use case, which is described below. The buttons below the description populate the APIs Explorer with sample values or open the fullscreen APIs Explorer to show code samples that use those values. The code samples also dynamically update if you change the values.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nDELETE https://www.googleapis.com/youtube/v3/playlistItems\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 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 item ID for the playlist item that is being deleted. In a `playlistItem` resource, the `id` property specifies the playlist item'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 No Content` status code.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Data API - Errors](/youtube/v3/docs/errors).\n\n| Error type | Error detail | Description |\n|----------------------|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `forbidden (403)` | `playlistItemsNotAccessible` | The request is not properly authorized to delete the specified playlist item. |\n| `notFound (404)` | `playlistItemNotFound` | The playlist item identified with the request's `id` parameter cannot be found. |\n| `invalidValue (400)` | `playlistOperationUnsupported` | The API does not support the ability to delete videos from the specified playlist. For example, you can't delete a video from your uploaded videos playlist. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
