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, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров YouTube, которые владеют несколькими каналами и управляют ими. Владельцы контента могут пройти аутентификацию один раз и получить доступ к данным всех своих видео и каналов. Аккаунт CMS, с помощью которого пользователь проходит аутентификацию, должен быть связан с указанным владельцем контента YouTube.

Тело запроса

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

Ответ

Если все пройдет успешно, этот метод вернет код статуса HTTP 204 No Content.

Ошибки

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

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

Попробовать

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