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 в теле запроса.

Ответ

В случае успеха этот метод возвращает код состояния 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.

,

Загружает изображение водяного знака на 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 в теле запроса.

Ответ

В случае успеха этот метод возвращает код состояния 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.