Watermarks: set

Загружает изображение водяного знака на YouTube и устанавливает его для канала.

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

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

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

Запрос

HTTP-запрос

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

Авторизация

Этот запрос требует авторизации по крайней мере в одной из следующих областей ( подробнее об аутентификации и авторизации ).

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

Параметры

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

Параметры
Обязательные параметры
channelId string
Параметр channelId указывает идентификатор канала YouTube, для которого предоставляется водяной знак.
Дополнительные параметры
onBehalfOfContentOwner string
Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube.

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

Тело запроса

Укажите ресурс водяного знака в теле запроса.

Ответ

В случае успеха этот метод возвращает код ответа HTTP 204 ( No Content ).

Ошибки

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

Тип ошибки Сведения об ошибке Описание
badRequest (400) imageFormatUnsupported Предоставленное вами изображение имеет неподдерживаемый формат.
badRequest (400) imageTooTall Предоставленное вами изображение слишком высокое.
badRequest (400) imageTooWide Предоставленное вами изображение слишком широкое.
badRequest (400) mediaBodyRequired Запрос не включает содержимое изображения.
forbidden (403) forbidden Невозможно установить водяной знак для указанного канала. Возможно, запрос не авторизован должным образом, или параметру channelId присвоено недопустимое значение.

Попробуй это!

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