Изменяет список воспроизведения. Например, вы можете изменить название, описание или статус конфиденциальности плейлиста.
Влияние квоты: вызов этого метода имеет стоимость квоты 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 , которые можно включить в значение параметра:
| |
Дополнительные параметры | ||
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.