ChannelBanners

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

方法

对于 channelBanners 资源，该 API 支持以下方法：

insert
将频道横幅图片上传到 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 属性的值，以便设置频道的横幅图片。