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