PlaylistItems: delete

Удаляет элемент плейлиста.

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

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

Запрос

HTTP-запрос

DELETE https://www.googleapis.com/youtube/v3/playlistItems

Авторизация

Для этого запроса требуется авторизация с хотя бы одной из следующих областей. Подробнее об аутентификации и авторизации читайте в статье Реализация авторизации 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, который удаляется. В ресурсе playlistItem свойство id указывает на идентификатор элемента плейлиста.
Необязательные параметры
onBehalfOfContentOwner string
Примечание. Параметр onBehalfOfContentOwner предназначен исключительно для партнеров YouTube по контенту и может использоваться только в авторизованном запросе.

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

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

Тело запроса

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

Ответ

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

Ошибки

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

Тип ошибки Сведения об ошибке Описание
forbidden (403) playlistItemsNotAccessible Запрос на удаление указанного объекта плейлиста не авторизован должным образом.
notFound (404) playlistItemNotFound Не удалось найти элемент плейлиста, указанный в параметре id запроса.
invalidValue (400) playlistOperationUnsupported API не поддерживает удаление видео из указанного плейлиста. Например, вы не можете удалить видео из плейлиста "Загрузки".

Попробовать

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