PlaylistItems: delete

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

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

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

Запрос

HTTP-запрос

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

Авторизация

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

Объем
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 Creator Studio.

Тело запроса

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

Ответ

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

Ошибки

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

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

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

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