Ресурс channelBanner
содержит URL-адрес, который вы можете использовать для установки только что загруженного изображения в качестве изображения баннера для канала.
Методы
API поддерживает следующие методы для ресурсов channelBanners
:
- insert
- Загружает изображение баннера канала на YouTube. Этот метод представляет собой первые два шага трехэтапного процесса обновления изображения баннера для канала:
- Вызовите
channelBanners.insert
, чтобы загрузить данные двоичного изображения на YouTube. Изображение должно иметь соотношение сторон 16:9 и размер не менее 2048x1152 пикселей. Мы рекомендуем загружать изображение размером 2560х1440 пикселей. - Извлеките значение свойства
url
из ответа, который API возвращает на шаге 1. - Вызовите метод
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 чтобы задать изображение баннера для канала. |