Playlists: insert

Создает плейлист.

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

Примеры использования

Запрос

HTTP-запрос

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

Авторизация

Для этого запроса требуется авторизация с хотя бы одной из следующих областей. Подробнее об аутентификации и авторизации читайте в статье Реализация авторизации OAuth 2.0.

Область действия
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
  • localizations
  • player
  • snippet
  • status
Необязательные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе.

Примечание. Этот параметр предназначен исключительно для партнеров YouTube по контенту.


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

Примечание. Этот параметр предназначен исключительно для партнеров YouTube по контенту.


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

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

Тело запроса

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

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

    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

Ответ

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

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробнее об ошибках YouTube Data API…

Тип ошибки Сведения об ошибке Описание
badRequest (400) defaultLanguageNotSetError defaultLanguage должен быть настроен на обновление localizations.
badRequest (400) localizationValidationError Одно из значений в объекте localizations не прошло проверку. Используйте метод playlists.list, чтобы получить допустимые значения, и обновите их в соответствии с инструкциями в документации по ресурсу playlist.
badRequest (400) maxPlaylistExceeded Не удалось создать плейлист, поскольку на канале уже есть максимально допустимое количество плейлистов.
forbidden (403) playlistForbidden Эта операция запрещена или запрос не авторизован.
invalidValue (400) invalidPlaylistSnippet В запросе указан недопустимый фрагмент плейлиста.
required (400) playlistTitleRequired В запросе должно быть указано название плейлиста.

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.