PlaylistImages: insert

将图片添加到播放列表。

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

  • 文件大小上限：2MB
  • 接受的宽高比：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 内容管理系统用户。此参数适用于拥有和管理多个不同 YouTube 频道的 YouTube 内容合作伙伴。有了它，内容所有者只需验证一次身份，即可访问自己所有的视频和频道数据，而无需为每个频道提供身份验证凭据。用户进行身份验证时使用的内容管理系统账号必须与指定的 YouTube 内容所有者相关联。
onBehalfOfContentOwnerChannel string
此参数只能在适当授权的请求中使用。注意：此参数仅适用于 YouTube 内容合作伙伴。

onBehalfOfContentOwnerChannel 参数 用于指定视频所面向的频道的 YouTube 频道 ID 已添加。如果请求为 onBehalfOfContentOwner 参数，且只能在 与该参数结合使用。此外，该请求必须是 使用与内容所有者的 onBehalfOfContentOwner 参数指定。最后， onBehalfOfContentOwnerChannel 参数值的通道 指定的广告必须与内容拥有者相关联的 onBehalfOfContentOwner参数指定的值。

此 参数适用于拥有和管理许多 不同 YouTube 频道它允许内容所有者进行身份验证一次 并代表参数中指定的渠道执行操作 而无需为每个字段提供身份验证凭据 独立频道

请求正文

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

对于该资源：

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

响应

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