Prepárate para que tu aplicación cliente funcione con Google Ad Manager

Recopila la información necesaria para tus aplicaciones cliente.

Debes tener la siguiente información que se requiere para que Google Ad Manager cree una sesión de transmisión en vivo:

CampoDescripción
projectNumberEs el número de proyecto de Google Cloud que se usa para crear sesiones habilitadas para Ad Manager. Como alternativa, puedes usar el ID del proyecto.
region La región en la que se registra la configuración activa.
liveConfigIdEl ID de configuración en vivo que se usa para registrar el evento de transmisión en vivo con la API de Video Stitcher. A continuación, se muestra el formato del nombre completo del recurso de configuración:

projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID
El ID de configuración es la última parte del nombre completo (LIVE_CONFIG_ID). Ten en cuenta que la ubicación de la configuración debe estar en la misma ubicación en la que creaste la sesión.
customAssetKeyEs la clave de elemento personalizada creada durante el registro de la configuración en vivo. El SDK de IMA necesita este valor para crear la transmisión.
networkCodeEs el identificador numérico de tu red de Ad Manager.
OAuth tokenUn token de OAuth de corta duración para la cuenta de servicio con el rol de Usuario de Video Stitcher. Consulta Cómo generar tokens de OAuth de corta duración.

Tabla 1. Información obligatoria para las sesiones de transmisión en vivo habilitadas para Ad Manager

Genera tokens de OAuth de corta duración para pruebas

Para generar un token de OAuth de corta duración asociado con la cuenta de servicio con la función Usuario de Video Stitcher, sigue estos pasos:

  1. Reemplaza PATH_TO_YOUR_SERVICE_KEY por la ruta de acceso al archivo JSON que descargaste en tu máquina local.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
    
  2. Recupera el token del portador de OAuth 2.0 de la cuenta de servicio:
    gcloud auth print-access-token
    

Debido a que se trata de un token de corta duración, debes volver a generarlo periódicamente con el comando gcloud auth print-access-token y enviar los tokens nuevos a las aplicaciones cliente. Consulta la siguiente sección si deseas obtener más información sobre la compilación de un servicio de producción para proporcionar tokens de corta duración.

Crea un servicio para proporcionar información a tus aplicaciones cliente

Crea un servicio que pueda proporcionar la información requerida que se pasará al cliente. Cuando la aplicación le solicita al servicio información sobre cómo reproducir una transmisión en vivo, el servicio debe mostrar la información descrita en la Tabla 1.

En particular, el servicio debe poder proporcionar tokens de OAuth a las aplicaciones cliente de manera segura. Configura este servicio con dos cuentas de servicio, una suplantando la identidad a la otra. Una cuenta de servicio tiene la función de Creador de tokens de servicio y crea un token de OAuth para la cuenta de servicio que tiene la función de Usuario de Video Stitcher. Por ejemplo:

  • Cuenta de servicio 1: Esta es la cuenta de servicio del emisor. Esta cuenta tiene el permiso Creador de tokens de servicio en la cuenta de servicio 2 y usa la cuenta de servicio 2 para las aplicaciones cliente.
  • Cuenta de servicio 2: Esta es la cuenta de servicio con privilegios que tiene la función de usuario de Video Stitcher para crear sesiones.

Para obtener información sobre cómo proporcionar un token OAuth desde tu servicio, incluidas las muestras de código de la biblioteca cliente, consulta Crea un token de acceso de corta duración.