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.

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

• Максимальный размер файла: 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, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров YouTube, которые владеют несколькими каналами и управляют ими. Владельцы контента могут пройти аутентификацию один раз и получить доступ к данным всех своих видео и каналов. Аккаунт CMS, с помощью которого пользователь проходит аутентификацию, должен быть связан с указанным владельцем контента YouTube.

Тело запроса

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

Ответ

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

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробнее об ошибках YouTube Data API…

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

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.