ChannelBanners

channelBanner содержит URL, который можно использовать, чтобы установить загруженное изображение в качестве баннера канала.

Методы

API поддерживает следующие методы для ресурсов channelBanners:

insert
Загружает баннер канала на YouTube. Этот метод представляет собой первые два шага в трехэтапном процессе обновления баннера канала:
  1. Вызовите метод channelBanners.insert, чтобы загрузить на YouTube двоичные данные изображения. Соотношение сторон должно быть 16:9, а размер – не менее 2048 x 1152 пикселей. Рекомендуемый размер изображения – 2560 x 1440 пкс.
  2. Извлеките значение свойства url из ответа, который API возвращает на шаге 1.
  3. Вызовите метод channels.update, чтобы обновить настройки фирменного оформления канала. Задайте для свойства brandingSettings.image.bannerExternalUrl значение URL, полученное на шаге 2.

Представление ресурса

Ниже приведена структура JSON для ресурса channelBanners:

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

Свойства

В таблице ниже описаны свойства, которые появляются в этом ресурсе.

Свойства
kind string
Определяет тип ресурса API. Значение будет youtube#channelBannerResource.
etag etag
Тег Etag этого ресурса.
url string
URL изображения баннера. После вызова метода channelBanners.insert извлеките это значение из ответа API. Затем вызовите метод channels.update и задайте URL в качестве значения свойства brandingSettings.image.bannerExternalUrl, чтобы установить баннер для канала.