Captions: delete

Удаляет указанную дорожку субтитров.

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

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

Запрос

HTTP-запрос

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

Авторизация

Для этого запроса требуется авторизация по крайней мере с одной из следующих областей действия. Подробнее об аутентификации и авторизации можно узнать в статье Как реализовать авторизацию OAuth 2.0.

Область действия
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Параметры

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

Параметры
Обязательные параметры
id string
Параметр id определяет дорожку субтитров, которую нужно удалить. Значение представляет собой идентификатор дорожки субтитров, который определяется свойством id в ресурсе caption.
Необязательные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе.

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

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

Тело запроса

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

Ответ

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

Ошибки

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

Тип ошибки Сведения об ошибке Описание
forbidden (403) forbidden У разрешений, связанных с запросом, недостаточно прав, чтобы удалить дорожку субтитров. Возможно, запрос не был авторизован должным образом.
notFound (404) captionNotFound Не удалось найти дорожку субтитров. Проверьте значение параметра id в запросе.

Попробовать

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