PlaylistItems: insert

Добавляет ресурс в список воспроизведения.

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

Распространенные случаи использования

Запрос

HTTP-запрос

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

Авторизация

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

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

Параметры

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

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

Следующий список содержит названия part , которые можно включить в значение параметра:
  • contentDetails
  • id
  • snippet
  • status
Дополнительные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube.

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

Тело запроса

Укажите ресурс playlistItem в теле запроса. Для этого ресурса:

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

    • snippet.playlistId
    • snippet.resourceId

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

    • snippet.playlistId
    • snippet.position
    • snippet.resourceId
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

Ответ

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

Ошибки

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

Тип ошибки Детализация ошибки Описание
forbidden (403) playlistContainsMaximumNumberOfVideos Список воспроизведения уже содержит максимально допустимое количество элементов.
forbidden (403) playlistItemsNotAccessible Запрос не авторизован должным образом для вставки указанного элемента списка воспроизведения.
invalidValue (400) invalidContentDetails Недопустимое свойство contentDetails в запросе. Возможная причина заключается в том, что поле contentDetails.note длиннее 280 символов.
invalidValue (400) invalidPlaylistItemPosition Запрос пытается установить для позиции элемента списка воспроизведения недопустимое или неподдерживаемое значение. Проверьте значение свойства position во snippet ресурса.
invalidValue (400) invalidResourceType type , указанный для идентификатора ресурса, не поддерживается для этой операции. Идентификатор ресурса идентифицирует элемент, добавляемый в список воспроизведения, например youtube#video .
invalidValue (400) manualSortRequired Запрос пытается установить положение элемента списка воспроизведения, но список воспроизведения не использует ручную сортировку. (Например, элементы плейлиста могут быть отсортированы по дате или популярности.) Эту ошибку можно устранить, удалив элемент snippet.position из ресурса, вставляемого запросом. Если вы хотите, чтобы элемент списка воспроизведения занимал определенную позицию в списке, вам необходимо сначала обновить параметр «Упорядочение » списка воспроизведения на «Вручную» в настройках списка воспроизведения. Эти настройки можно изменить в Менеджере видео YouTube .
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Видео, которое вы пытаетесь добавить в плейлист, уже находится в плейлисте другой серии.
notFound (404) playlistNotFound Список воспроизведения, указанный в параметре playlistId запроса, не найден.
notFound (404) videoNotFound Видео, которое вы пытаетесь добавить в плейлист, не найдено. Проверьте значение свойства videoId , чтобы убедиться, что оно правильное.
required (400) channelIdRequired В запросе не указано значение обязательного свойства channelId .
required (400) playlistIdRequired В запросе не указано значение обязательного свойства playlistId .
required (400) resourceIdRequired Запрос должен содержать ресурс, в котором объект snippet указывает идентификатор resourceId .
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность вставки видео в указанный плейлист. Например, вы не можете вставить видео в список воспроизведения загруженных видео.

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

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.