Preparar la aplicación de tu cliente para que funcione con Google Ad Manager

Recoger la información necesaria para las solicitudes de tus clientes

Debe tener la siguiente información, que es necesaria para que Google Ad Manager cree una sesión de emisión en directo:

CampoDescripción
projectNumberEl Google Cloud número de proyecto (PROJECT_NUMBER) que se usa para crear sesiones habilitadas para Ad Manager. También puede usar el ID de proyecto.
region La ubicación (LOCATION) donde se registra la configuración activa.
liveConfigIdID de configuración en directo que se usa para registrar el evento de emisión en directo con la API Video Stitcher. A continuación, se muestra el formato del nombre de recurso de configuración completo:
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 configuración debe estar en la misma ubicación en la que crees la sesión.
customAssetKeyLa clave de recurso personalizada (CUSTOM_ASSET_KEY) creada durante el registro de la configuración de la emisión en directo. El SDK de IMA necesita este valor para crear la emisión.
networkCodeEl identificador numérico (NETWORK_CODE) de su red de Ad Manager.
oAuthTokenUn token de OAuth de corta duración para la cuenta de servicio con el rol Usuario de Video Stitcher. Consulta Generar tokens de OAuth de corta duración.

Tabla 1. Información obligatoria para las sesiones de emisiones en directo habilitadas en Ad Manager

Generar tokens de OAuth de corta duración para pruebas

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

  1. Sustituye PATH_TO_YOUR_SERVICE_KEY por la ruta al archivo JSON que has descargado en tu ordenador.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
  2. Obtén el token de portador de OAuth 2.0 de la cuenta de servicio:
    gcloud auth print-access-token

Como se trata de un token de corta duración, debes generarlo de nuevo periódicamente con el comando gcloud auth print-access-token y enviar los nuevos tokens a tus aplicaciones cliente. Consulta la siguiente sección para obtener más información sobre cómo crear un servicio de producción que proporcione tokens de corta duración.

Crear un servicio para proporcionar información a las aplicaciones cliente

Crea un servicio que pueda proporcionar la información necesaria para enviarla al cliente. Cuando la aplicación solicite información a tu servicio sobre cómo reproducir una emisión en directo, el servicio debe devolver la información descrita en la tabla 1.

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

  • Cuenta de servicio 1: es la cuenta de servicio de la persona que llama. Esta cuenta tiene el permiso Creador de tokens de servicio en la cuenta de servicio 2 y suplanta la identidad de la cuenta de servicio 2 en las aplicaciones cliente.
  • Cuenta de servicio 2: es la cuenta de servicio con privilegios que tiene el rol Usuario de Video Stitcher para crear sesiones.

Para obtener información sobre cómo proporcionar un token de OAuth desde tu servicio, incluidos ejemplos de código de la biblioteca de cliente, consulta Crear un token de acceso de corta duración.