Playlists: update

Изменяет список воспроизведения. Например, вы можете изменить название, описание или статус конфиденциальности плейлиста.

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

Общие варианты использования

Запрос

HTTP-запрос

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

Авторизация

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

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

Параметры

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

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

Обратите внимание, что этот метод переопределит существующие значения изменяемых свойств, содержащихся в любых частях, указанных в тексте запроса. Например, описание плейлиста содержится в snippet , который должен быть включен в тело запроса. Если в запросе не указано значение свойства snippet.description , существующее описание плейлиста будет удалено.

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

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

Тело запроса

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

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

    • id
    • snippet.title

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

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

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

Ответ

В случае успеха этот метод возвращает ресурс списка воспроизведения в теле ответа.

Ошибки

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

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

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

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