Watermarks: unset
删除频道的水印图片。
对配额的影响:调用此方法会产生 50 个单元的配额费用。
请求
HTTP 请求
POST https://www.googleapis.com/youtube/v3/watermarks/unset
授权
此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。
范围 |
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
参数
下表列出了此查询支持的参数。列出的所有参数都是查询参数。
参数 |
必需参数 |
channelId |
string
channelId 参数用于指定未设置水印的 YouTube 频道 ID。 |
可选参数 |
onBehalfOfContentOwner |
string
注意:此参数仅适用于 YouTube 内容合作伙伴。
onBehalfOfContentOwner 参数用于指明该请求的授权凭据会标识代表参数值中指定的内容所有者的 YouTube 内容管理系统用户。此参数适用于拥有和管理众多不同 YouTube 频道的 YouTube 内容合作伙伴。它可让内容所有者在一次身份验证后获得访问其所有视频和频道数据的权限,而无需为每个频道提供身份验证凭据。用户进行身份验证时所用的 CMS 账号必须与指定的 YouTube 内容所有者相关联。 |
响应
如果成功,此方法将返回 HTTP 204
响应代码 (No Content
)。
错误
下表列出了 API 在响应对此方法的调用时可能会返回的错误消息。如需了解详情,请参阅错误消息文档。
错误类型 |
错误详情 |
说明 |
forbidden (403) |
forbidden |
无法为指定频道取消设置水印。请求可能未正确授权,或者 channelId 参数设置为无效值。 |
试试看!
使用 APIs Explorer 调用此 API 并查看 API 请求和响应。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-04-26。
[null,null,["最后更新时间 (UTC):2024-04-26。"],[[["This API method removes a watermark image from a specified YouTube channel."],["A successful call to this API returns an HTTP `204` response, indicating no content."],["The request requires authorization using `youtubepartner`, `youtube`, or `youtube.force-ssl` scopes."],["The required parameter `channelId` specifies the YouTube channel from which the watermark is being removed."],["The optional `onBehalfOfContentOwner` parameter is available for YouTube content partners to manage multiple channels under one authorization."]]],["This API method deletes a channel's watermark image. It requires authorization with specific scopes and incurs a quota cost of 50 units per call. The request is made via a POST request to the specified URL, requiring the `channelId` parameter, and optionally `onBehalfOfContentOwner`. A successful call returns a `204` response, while a `403` error indicates issues with authorization or an invalid `channelId`. No request body is used for the call.\n"]]