Playlists: delete

Удаляет список воспроизведения.

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

Распространенные случаи использования

Запрос

HTTP-запрос 

DELETE 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

Параметры

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

Параметры
Обязательные параметры
id string
Параметр id указывает идентификатор плейлиста YouTube для удаляемого плейлиста. В ресурсе playlist свойство id указывает идентификатор списка воспроизведения.
Дополнительные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в должным образом авторизованном запросе .

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

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

Тело запроса

Не указывайте тело запроса при вызове этого метода.

Ответ

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

Ошибки

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

Тип ошибки Детализация ошибки Описание
forbidden (403) playlistForbidden Эта операция запрещена или запрос не авторизован должным образом.
notFound (404) playlistNotFound Невозможно найти список воспроизведения, указанный в параметре id запроса.
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность удаления указанного плейлиста. Например, вы не можете удалить список воспроизведения загруженных видео.

Попробуйте!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.

,

Удаляет список воспроизведения.

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

Распространенные случаи использования

Запрос

HTTP-запрос 

DELETE 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

Параметры

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

Параметры
Обязательные параметры
id string
Параметр id указывает идентификатор плейлиста YouTube для удаляемого плейлиста. В ресурсе playlist свойство id указывает идентификатор списка воспроизведения.
Дополнительные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в должным образом авторизованном запросе .

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

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

Тело запроса

Не указывайте тело запроса при вызове этого метода.

Ответ

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

Ошибки

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

Тип ошибки Детализация ошибки Описание
forbidden (403) playlistForbidden Эта операция запрещена или запрос не авторизован должным образом.
notFound (404) playlistNotFound Невозможно найти список воспроизведения, указанный в параметре id запроса.
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность удаления указанного плейлиста. Например, вы не можете удалить список воспроизведения загруженных видео.

Попробуйте!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.