PlaylistImages: insert

向播放列表添加图片。

此方法支持媒体上传。上传的文件必须符合以下限制条件：

  • 文件大小上限： 50MB
  • 接受的宽高比： 1:1（方形）
  • 接受的媒体 MIME 类型： image/jpeg、image/png

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

请求

HTTP 请求

POST 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
此参数只能在经过适当授权的请求中使用。注意： 此参数仅供 YouTube 内容合作伙伴使用。

onBehalfOfContentOwner 参数表示请求的授权凭据标识的是代表参数值中指定的内容所有者行事的 YouTube 内容管理系统 (CMS) 用户。此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。它允许内容所有者进行一次身份验证，即可访问其所有视频和频道数据，而无需为每个频道提供身份验证凭据。用户进行身份验证时使用的 CMS 账号必须与指定的 YouTube 内容所有者相关联。
onBehalfOfContentOwnerChannel string
此参数只能在经过适当授权的请求中使用。注意： 此参数仅供 YouTube 内容合作伙伴使用。

该 onBehalfOfContentOwnerChannel参数 指定了要 添加视频的 YouTube 频道的频道 ID。当请求为 onBehalfOfContentOwner 参数指定值时，此参数是必需的，并且只能与该参数搭配使用。此外，必须使用与 onBehalfOfContentOwner 参数指定的内容所有者相关联的 CMS 账号对请求进行授权。最后， onBehalfOfContentOwnerChannel参数值指定的频道必须与 onBehalfOfContentOwner参数指定的内容所有者相关联。

此 参数适用于拥有和管理许多 不同 YouTube 频道的 YouTube 内容合作伙伴。它允许内容所有者进行一次身份验证 即可代表参数 值中指定的频道执行操作，而无需为每个 单独的频道提供身份验证凭据。

请求正文

在请求正文中提供 playlistImages 资源。

对于该资源：

  • 您必须为以下属性指定值：

    • snippet.playlistId
    • snippet.type

  • 您可以为以下属性设置值：

    • snippet.width
    • snippet.height

响应

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