Удаляет элемент списка воспроизведения.
Влияние квоты. Стоимость вызова этого метода составляет 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.