Watermarks: set

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

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

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

Влияние на квоту: вызов этого метода влечет за собой затраты в размере 50 единиц квоты .

Запрос

HTTP-запрос 

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

Авторизация

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

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

Текст запроса

Укажите ресурс watermark в теле запроса. Ресурс содержит следующие свойства:

  • timing ( object , required): Инкапсулирует время отображения водяного знака.
    • timing.type ( string , required): Установите значение либо offsetFromStart , либо offsetFromEnd .
    • timing.offsetMs ( unsigned long , required): Начальное смещение в миллисекундах. Должно быть не менее 1000 мс, если type — offsetFromEnd .
    • timing.durationMs ( unsigned long , optional): Видимая длительность в миллисекундах (минимум 1000 мс). Если type — offsetFromEnd , значение не должно превышать offsetMs .
  • targetChannelId ( string , необязательно): Идентификатор канала YouTube, на который ведет водяной знак. Если опущен, ведет на канал, идентифицированный параметром channelId .
  • position ( object , deprecated): Проигнорировано YouTube. Водяные знаки всегда размещаются в правом верхнем углу.

Ответ

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

Ошибки

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

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

Попробуйте!

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