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.playlistId
    • snippet.type
  • 您可以为以下属性设置值:

    • snippet.width
    • snippet.height

响应

如果成功,此方法会在响应正文中返回 playlistItem 资源。