ChannelBanners

channelBanner 资源包含用于将新上传的图片设为频道的横幅图片的网址。

方法

该 API 支持 channelBanners 资源的以下方法:

插入
将频道横幅图片上传到 YouTube。此方法表示更新频道横幅图片的三个步骤中的前两个步骤:

  1. 调用 channelBanners.insert 方法,将二进制图片数据上传到 YouTube。图片的宽高比必须为 16:9,且至少为 2048x1152 像素。我们建议您上传一张 2560x1440 像素的图片。
  2. 从 API 针对第 1 步返回的响应中提取 url 属性的值。
  3. 调用 channels.update 方法以更新频道的品牌设置。将 brandingSettings.image.bannerExternalUrl 属性的值设置为第 2 步中获得的网址。

资源表示法

以下 JSON 结构显示了 channelBanners 资源的格式:

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

属性

下表定义了此资源中显示的属性:

属性
kind string
标识 API 资源类型。值为 youtube#channelBannerResource
etag etag
此资源的 Etag。
url string
横幅图片的网址。调用 channelBanners.insert 方法后,从 API 响应中提取此值。然后调用 channels.update 方法,并将网址设为 brandingSettings.image.bannerExternalUrl 属性的值,即可设置频道的横幅图片。