Con la API de Video Stitcher, creas una sesión en vivo cada vez que inicias la reproducción de una transmisión en vivo en la que los anuncios publicados por Google Ad Manager se unen de forma dinámica durante las pausas publicitarias. La respuesta especifica la URL de reproducción y la configuración de la sesión en vivo.
En este documento, se describe cómo crear y administrar una sesión en vivo. Para obtener más detalles, consulta la documentación de REST.
Antes de comenzar
- Crea una configuración en vivo. Para la integración con Google Ad Manager, asegúrate de que el objeto
gamLiveConfig
esté configurado. - Si especificas una lista, asegúrate de que el objeto
gamSlate
esté configurado en la lista que registres.
Cómo crear una sesión en vivo
Para crear una sesión en vivo directamente con la API, usa el método projects.locations.liveSessions.create
.
El campo liveConfig
es el único campo obligatorio en el cuerpo JSON. Puedes establecer o anular los siguientes parámetros opcionales por sesión en vivo (como se muestra en el siguiente ejemplo de REST):
manifestOptions
: Especifica qué representaciones de video se generan en el manifiesto de video unido y el orden de las representaciones. Consulta la documentación de las opciones de manifiesto.adTracking
: Selecciona el seguimiento de anuncios del cliente o el seguimiento de anuncios del servidor. Esto anula el valor de la configuración activa para la sesión.targetingParameters
: Una etiqueta de anuncio de Google Ad Manager puede contener parámetros de segmentación que se pueden actualizar por sesión. Proporciona una asignación en este campo (por ejemplo, para reemplazar la macro[my_key]
por la cadenamy_value
, consulta el ejemplo de REST).
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER
: Tu número de Google Cloud proyecto, que se encuentra en el campo Número de proyecto de la página Configuración de IAMLOCATION
: Es la ubicación en la que se creará tu sesión. Usa una de las regiones compatibles.Mostrar ubicacionesus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
LIVE_CONFIG_ID
: Es el identificador definido por el usuario para la configuración activa.
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", "playUri": "PLAY_URI", "manifestOptions": { "includeRenditions": [ { "bitrateBps": 150000, "codecs": "hvc1.1.4.L126.B0" }, { "bitrateBps": 440000, "codecs": "hvc1.1.4.L126.B0" } ], "bitrateOrder": "DESCENDING" }, "gamSettings": { "streamId": "STREAM_ID" }, "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", "adTracking": "SERVER" }
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher C#.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Go.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Java.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Node.js.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher PHP.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Python.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Ruby.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
La API de Video Stitcher genera un ID de sesión único para cada solicitud. Una sesión vence si no se solicita playUri
en los últimos 5 minutos.
Puedes usar el STREAM_ID
que se muestra para inspeccionar la sesión en vivo.
Inspecciona las sesiones en vivo habilitadas por Google Ad Manager
Para ver los detalles de las etiquetas de anuncios de las sesiones, usa el Supervisor de actividad de transmisión en Ad Manager para ver los detalles de las solicitudes de anuncios. Puedes usar STREAM_ID
para depurar la sesión de transmisión. Para encontrar el STREAM_ID
de una sesión en vivo, consulta Obtén una sesión.