Ресурс 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 , чтобы установить изображение баннера для канала. |