PlaylistImages: insert

Добавляет изображение в плейлист.

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

  • Максимальный размер файла: 50 МБ.
  • Допустимое соотношение сторон: 1:1 (квадрат).
  • Поддерживаемые MIME-типы медиаконтента: image/jpeg, image/png.

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

Запрос

HTTP-запрос

POST https://www.googleapis.com/youtube/v3/playlistImages

Авторизация

Для выполнения этого запроса требуется авторизация как минимум в одной из следующих областей доступа. Подробнее…

Область действия
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

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

Параметры
Обязательные параметры
part string

Параметр part представляет собой разделенный запятыми список, в котором перечислены одно или несколько свойств ресурса playlistImage, которые будут включены в ответ API.

Если параметр определяет свойство, содержащее дочерние свойства, то они также будут включены в ответ.
Необязательные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе. Примечание. Этот параметр предназначен исключительно для партнеров YouTube по контенту.

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

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

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

Тело запроса

В теле запроса укажите ресурс playlistImages.

Для этого ресурса:

  • Для следующих свойств необходимо указать значение:

    • snippet.playlistId
    • snippet.type

  • Вы можете задать значения для следующих свойств:

    • snippet.width
    • snippet.height

Ответ

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