Cambia el estado de una transmisión en vivo de YouTube y, luego, inicia los procesos asociados con el nuevo estado. Por ejemplo, cuando cambias el estado de una transmisión a testing, YouTube comienza a transmitir video a la transmisión del monitor de esa transmisión. Antes de llamar a este método, debes confirmar que el valor de la propiedad status.streamStatus para la transmisión vinculada a tu transmisión sea active.
Casos de uso habituales
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes permisos. Para obtener más información sobre la autenticación y autorización, consulta Cómo implementar la autenticación de OAuth 2.0.
| Alcance |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parámetros
En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.
| Parámetros | ||
|---|---|---|
| Parámetros obligatorios | ||
broadcastStatus |
stringEl parámetro broadcastStatus identifica el estado al que cambia la transmisión. Ten en cuenta que, para migrar una transmisión al estado testing o live, status.streamStatus debe ser active para la transmisión a la que está vinculada la transmisión.Los valores aceptables son los siguientes:
|
|
id |
stringEl parámetro id especifica el ID único de la transmisión que está realizando la transición a otro estado. |
|
part |
stringEl parámetro part especifica una lista separada por comas de una o más propiedades de recursos liveBroadcast que incluirá la respuesta de la API. Los nombres part que puedes incluir en el valor del parámetro son id, snippet, contentDetails y status. |
|
| Parámetros opcionales | ||
onBehalfOfContentOwner |
stringEste parámetro solo se puede usar en una solicitud autorizada correctamente. Nota: Este parámetro está destinado exclusivamente a los socios de contenido de YouTube. El parámetro onBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario del CMS de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro. Este parámetro está dirigido a socios de contenido de YouTube que poseen y administran muchos canales de YouTube diferentes. Permite a los propietarios del contenido autenticarse una vez y tener acceso a todos los datos de sus videos y canales, sin tener que proporcionar credenciales de autenticación para cada canal. La cuenta de CMS con la que se autentica el usuario debe estar relacionada con el propietario del contenido de YouTube especificado. |
|
onBehalfOfContentOwnerChannel |
stringEste parámetro solo se puede usar en una solicitud autorizada. Nota: Este parámetro está destinado exclusivamente a los socios de contenido de YouTube. El parámetro onBehalfOfContentOwnerChannel especifica el ID del canal de YouTube al que se agrega un video. Este parámetro es obligatorio cuando una solicitud especifica un valor para el parámetro onBehalfOfContentOwner y solo se puede usar junto con ese parámetro. Además, la solicitud debe estar autorizada con una cuenta de CMS vinculada al propietario del contenido que especifica el parámetro onBehalfOfContentOwner. Por último, el canal que especifica el valor del parámetro onBehalfOfContentOwnerChannel debe estar vinculado al propietario del contenido que especifica el parámetro onBehalfOfContentOwner.Este parámetro está destinado a los socios de contenido de YouTube que poseen y administran muchos canales de YouTube diferentes. Permite a los propietarios de contenido autenticarse una vez y llevar a cabo acciones en nombre del canal especificado en el valor del parámetro, sin tener que proporcionar credenciales de autenticación para cada canal por separado. |
|
Cuerpo de la solicitud
No proporciones un cuerpo de solicitud cuando invoques este método.
Respuesta
Si se aplica correctamente, este método muestra un recurso de liveBroadcast en el cuerpo de la respuesta.
Errores
En la siguiente tabla, se identifican los mensajes de error que podría mostrar la API en respuesta a una llamada a este método. Para obtener más información, consulta API de YouTube Live Streaming: Errores.
| Tipo de error | Detalle del error | Descripción |
|---|---|---|
backendError |
errorExecutingTransition |
Se produjo un error cuando se cambiaba el estado de la transmisión. |
forbidden (403) |
errorStreamInactive |
No se permite la transición solicitada cuando la transmisión vinculada a la transmisión está inactiva. |
forbidden (403) |
invalidTransition |
La transmisión en vivo no puede pasar de su estado actual al estado solicitado. |
forbidden (403) |
redundantTransition |
La transmisión en vivo ya tiene el estado solicitado o está en proceso de cambiar a ese estado. |
insufficientPermissions |
insufficientLivePermissions |
La solicitud no está autorizada para realizar la transición de la transmisión en vivo. |
insufficientPermissions |
livePermissionBlocked |
El usuario que autorizó la solicitud no puede transmitir videos en vivo en YouTube en este momento. Para obtener detalles sobre por qué el usuario no puede transmitir un video en vivo, consulta la configuración del canal del usuario en Elegibilidad para las funciones. |
insufficientPermissions |
liveStreamingNotEnabled |
El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. Para obtener más información, consulta Elegibilidad de las funciones. |
notFound (404) |
liveBroadcastNotFound |
No existe la transmisión especificada por el parámetro id. |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
El usuario envió demasiadas solicitudes en un período determinado. |
required (400) |
idRequired |
El parámetro id obligatorio debe identificar la transmisión cuyo estado deseas migrar. |
required (400) |
statusRequired |
La solicitud a la API debe especificar un valor para el parámetro status. |
Pruébalo
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.