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