ChannelBanners

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

方法

该 API 支持对 channelBanners 资源使用以下方法：

insert
将频道横幅图片上传到 YouTube。此方法代表更新频道横幅图片的三步流程中的前两步：
  1. 调用 channelBanners.insert 方法将二进制映像数据上传到 YouTube。图片的宽高比必须为 16:9，且至少为 2048x1152 像素。建议上传 2560 x 1440 像素的图片。
  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 属性的值，以设置频道的横幅图片。