Удаляет видеопоток.
Примеры использования
Запрос
HTTP-запрос
DELETE https://www.googleapis.com/youtube/v3/liveStreams
Авторизация
Для этого запроса требуется авторизация с хотя бы одной из следующих областей. Подробнее о реализации аутентификации OAuth 2.0…
| Область действия |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Параметры
В таблице ниже перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.
| Параметры | ||
|---|---|---|
| Обязательные параметры | ||
id |
stringПараметр id указывает идентификатор трансляции YouTube Live для удаляемого ресурса. |
|
| Необязательные параметры | ||
onBehalfOfContentOwner |
stringЭтот параметр можно использовать только в авторизованном запросе. Примечание. Этот параметр предназначен исключительно для партнеров YouTube. Параметр onBehalfOfContentOwner указывает, что учетные данные авторизации запроса идентифицируют пользователя системы управления контентом YouTube, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров YouTube, которые владеют несколькими каналами и управляют ими. Владельцы контента могут пройти аутентификацию один раз и получить доступ к данным всех своих видео и каналов. Аккаунт CMS, с помощью которого пользователь проходит аутентификацию, должен быть связан с указанным владельцем контента YouTube. |
|
onBehalfOfContentOwnerChannel |
stringЭтот параметр можно использовать только в авторизованном запросе. Примечание. Этот параметр предназначен исключительно для партнеров YouTube. Параметр onBehalfOfContentOwnerChannel указывает идентификатор канала YouTube, на который добавляется видео. Этот параметр обязателен, если в запросе указано значение параметра onBehalfOfContentOwner, и может использоваться только вместе с ним. Кроме того, запрос должен быть авторизован с помощью аккаунта CMS, связанного с владельцем контента, указанным в параметре onBehalfOfContentOwner. Наконец, канал, который указывает значение параметра onBehalfOfContentOwnerChannel, должен быть связан с владельцем контента, который указывает параметр onBehalfOfContentOwner.Этот параметр предназначен для партнеров YouTube по контенту, которые владеют множеством каналов YouTube и управляют ими. Владельцы контента могут один раз пройти аутентификацию и выполнять действия от имени канала, указанного в значении параметра, не предоставляя учетные данные для каждого отдельного канала. |
|
Тело запроса
При вызове этого метода не указывайте тело запроса.
Ответ
Если запрос выполнен успешно, этот метод возвращает ресурс liveStream в теле ответа.
Ошибки
В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробнее о сообщениях об ошибках…
| Тип ошибки | Сведения об ошибке | Описание |
|---|---|---|
forbidden (403) |
liveStreamDeletionNotAllowed |
Указанную трансляцию нельзя удалить, поскольку она связана с незавершенной трансляцией. |
insufficientPermissions |
insufficientLivePermissions |
У вас нет разрешения на удаление указанной трансляции. Подробнее о реализации аутентификации OAuth2… |
insufficientPermissions |
liveStreamingNotEnabled |
Пользователь, авторизовавший запрос, не может проводить прямые трансляции на YouTube. Подробнее о доступности функций… |
notFound (404) |
liveStreamNotFound |
Указанная трансляция не существует. |
Попробовать
Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.