ChannelBanners: insert

Загружает изображение баннера канала на YouTube. Этот метод представляет собой первые два шага трехэтапного процесса обновления изображения баннера для канала:

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

Этот метод поддерживает загрузку мультимедиа. Загруженные файлы должны соответствовать следующим ограничениям:

  • Максимальный размер файла: 6 МБ.
  • Допустимые типы MIME мультимедиа: image/jpeg , image/png , application/octet-stream

Влияние квоты. Стоимость вызова этого метода составляет 50 единиц.

Запрос

HTTP-запрос 

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

Авторизация

Для этого запроса требуется авторизация хотя бы с одной из следующих областей. Дополнительные сведения об аутентификации и авторизации см. в разделе «Реализация авторизации OAuth 2.0» .

Объем
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

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

Параметры
Дополнительные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в должным образом авторизованном запросе .

Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube.

Параметр onBehalfOfContentOwner указывает, что учетные данные авторизации запроса идентифицируют пользователя YouTube CMS, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Это позволяет владельцам контента один раз пройти аутентификацию и получить доступ ко всем своим видео и данным каналов без необходимости предоставлять учетные данные аутентификации для каждого отдельного канала. Учетная запись CMS, с помощью которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента YouTube.

Тело запроса

Не указывайте тело запроса при вызове этого метода.

Ответ

В случае успеха этот метод возвращает ресурс channelBanner в теле ответа.

Ошибки

В следующей таблице указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Дополнительные сведения см. в разделе API данных YouTube — ошибки .

Тип ошибки Детализация ошибки Описание
badRequest (400) bannerAlbumFull В вашем альбоме «Обложки канала YouTube» слишком много изображений. Чтобы это исправить, перейдите в Google Фото , затем перейдите на страницу альбомов и удалите некоторые изображения из этого альбома.
badRequest (400) mediaBodyRequired Запрос не включает содержимое изображения.

Попробуйте!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.