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

Тело запроса

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

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

Ответ

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

Ошибки

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

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

Попробовать

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