PlaylistItems: delete

删除播放列表项。

配额影响:调用此方法的配额费用为 50 个单位。

常见使用场景

请求

HTTP 请求

DELETE https://www.googleapis.com/youtube/v3/playlistItems

授权

此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。

范围
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 为响应对此方法的调用可能返回的错误消息。如需了解详情,请参阅错误消息文档。

错误类型 错误详情 说明
forbidden (403) playlistItemsNotAccessible 该请求未获得适当授权,无法删除指定的播放列表项。
notFound (404) playlistItemNotFound 找不到使用请求的 id 参数标识的播放列表项。
invalidValue (400) playlistOperationUnsupported 该 API 不支持从指定的播放列表中删除视频。例如,您无法从上传的视频播放列表中删除视频。

试试看!

使用 APIs Explorer 调用此 API,并查看 API 请求和响应。