Изменяет статус прямой трансляции YouTube и инициирует любые процессы, связанные с новым статусом. Например, когда вы переводите статус трансляции на testing , YouTube начинает передавать видео в поток монитора этой трансляции. Перед вызовом этого метода следует убедиться, что значение свойства status.streamStatus для потока, привязанного к вашей трансляции, active .
Распространенные случаи использования
Запрос
HTTP-запрос
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition
Авторизация
Для этого запроса требуется авторизация хотя бы с одной из следующих областей. Дополнительные сведения об аутентификации и авторизации см. в разделе «Реализация аутентификации OAuth 2.0» .
| Объем |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Параметры
В следующей таблице перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.
| Параметры | ||
|---|---|---|
| Обязательные параметры | ||
broadcastStatus | stringПараметр broadcastStatus определяет состояние, в которое изменяется широковещательная рассылка. Обратите внимание: чтобы перевести широковещательную рассылку в состояние testing или в режиме live , status.streamStatus должен быть active для потока, к которому привязана широковещательная рассылка.Приемлемые значения:
| |
id | stringПараметр id указывает уникальный идентификатор широковещательной рассылки, которая переходит в другой статус. | |
part | stringПараметр part указывает разделенный запятыми список одного или нескольких свойств ресурса liveBroadcast , которые будут включены в ответ API. Имена part , которые вы можете включить в значение параметра: id , snippet , contentDetails и status . | |
| Дополнительные параметры | ||
onBehalfOfContentOwner | stringЭтот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube. Параметр onBehalfOfContentOwner указывает, что учетные данные авторизации запроса идентифицируют пользователя YouTube CMS, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Это позволяет владельцам контента один раз пройти аутентификацию и получить доступ ко всем своим видео и данным каналов без необходимости предоставлять учетные данные аутентификации для каждого отдельного канала. Учетная запись CMS, с помощью которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента YouTube. | |
onBehalfOfContentOwnerChannel | stringЭтот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube. Параметр onBehalfOfContentOwnerChannel указывает идентификатор канала YouTube, на который добавляется видео. Этот параметр является обязательным, если в запросе указано значение параметра onBehalfOfContentOwner , и его можно использовать только вместе с этим параметром. Кроме того, запрос должен быть авторизован с использованием учетной записи CMS, связанной с владельцем контента, указанным в параметре onBehalfOfContentOwner . Наконец, канал, указанный в значении параметра onBehalfOfContentOwnerChannel должен быть связан с владельцем контента, указанным в параметре onBehalfOfContentOwner .Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Он позволяет владельцам контента один раз пройти аутентификацию и выполнять действия от имени канала, указанного в значении параметра, без необходимости предоставления учетных данных аутентификации для каждого отдельного канала. | |
Тело запроса
Не указывайте тело запроса при вызове этого метода.
Ответ
В случае успеха этот метод возвращает ресурс liveBroadcast в теле ответа.
Ошибки
В следующей таблице указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Дополнительные сведения см. в разделе API потоковой передачи YouTube Live — ошибки .
| Тип ошибки | Детализация ошибки | Описание |
|---|---|---|
backendError | errorExecutingTransition | Произошла ошибка при изменении статуса трансляции. |
forbidden (403) | errorStreamInactive | Запрошенный переход не разрешен, если поток, привязанный к широковещанию, неактивен. |
forbidden (403) | invalidTransition | Прямая трансляция не может перейти из текущего статуса в запрошенный. |
forbidden (403) | redundantTransition | Прямая трансляция уже находится в запрошенном статусе или обрабатывается до запрошенного статуса. |
insufficientPermissions | insufficientLivePermissions | Запрос не авторизован для перехода в прямом эфире. |
insufficientPermissions | livePermissionBlocked | Пользователь, авторизовавший запрос, в настоящее время не может транслировать видео в реальном времени на YouTube. Подробные сведения о том, почему пользователь не может транслировать видео в реальном времени, см. в настройках канала пользователя в разделе «Доступность функций» . |
insufficientPermissions | liveStreamingNotEnabled | Пользователь, авторизовавший запрос, не имеет права транслировать видео в реальном времени на YouTube. Дополнительную информацию см. в разделе «Приемлемость функций» . |
notFound (404) | liveBroadcastNotFound | Широковещательная рассылка, указанная параметром id , не существует. |
rateLimitExceeded (403) | userRequestsExceedRateLimit | Пользователь отправил слишком много запросов за определенный период времени. |
required (400) | idRequired | Обязательный параметр id должен идентифицировать трансляцию, статус которой вы хотите изменить. |
required (400) | statusRequired | В запросе API должно быть указано значение параметра status . |
Попробуйте!
Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.