Ресурс 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 | etagEtag этого ресурса. |
url | stringURL-адрес изображения баннера. После вызова метода channelBanners.insert извлеките это значение из ответа API. Затем вызовите метод channels.update и установите URL-адрес в качестве значения свойства brandingSettings.image.bannerExternalUrl чтобы задать изображение баннера для канала. |