Préparer votre application cliente à fonctionner avec Google Ad Manager

Collecter les informations requises pour vos applications clientes

Vous devez disposer des informations suivantes, qui sont requises pour que Google Ad Manager crée une session de streaming en direct:

ChampDescription
projectNumberLe Google Cloud numéro de projet (PROJECT_NUMBER) utilisé pour créer des sessions compatibles avec Ad Manager. Vous pouvez également utiliser l'ID du projet.
region Emplacement (LOCATION) où la configuration en direct est enregistrée.
liveConfigIdID de configuration en direct utilisé pour enregistrer l'événement de diffusion en direct avec l'API Video Stitcher. Voici le format du nom complet de la ressource de configuration:
projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID
La configuration ID est la dernière partie du nom complet (LIVE_CONFIG_ID). N'oubliez pas que l'emplacement de la configuration doit être le même que celui où vous créez la session.
customAssetKeyClé d'élément personnalisée (CUSTOM_ASSET_KEY) créée lors de l'enregistrement de la configuration en direct. Le SDK IMA a besoin de cette valeur pour créer le flux.
networkCodeIdentifiant numérique (NETWORK_CODE) de votre réseau Ad Manager.
oAuthTokenUn jeton OAuth de courte durée pour le compte de service avec le rôle Utilisateur de l'outil de montage vidéo. Consultez la section Générer des jetons OAuth éphémères.

Table 1. Informations requises pour les sessions de diffusion en direct compatibles avec Ad Manager

Générer des jetons OAuth de courte durée pour les tests

Pour générer un jeton OAuth de courte durée associé au compte de service avec le rôle Utilisateur de l'outil de montage vidéo, procédez comme suit:

  1. Remplacez PATH_TO_YOUR_SERVICE_KEY par le chemin d'accès au fichier JSON que vous avez téléchargé sur votre ordinateur local.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
  2. Récupérez le jeton de support OAuth 2.0 à partir du compte de service:
    gcloud auth print-access-token

Étant donné qu'il s'agit d'un jeton de courte durée, vous devez le générer à nouveau régulièrement à l'aide de la commande gcloud auth print-access-token et envoyer les nouveaux jetons à vos applications clientes. Pour en savoir plus sur la création d'un service de production permettant de fournir des jetons de courte durée, consultez la section suivante.

Créer un service pour fournir des informations à vos applications clientes

Créez un service pouvant fournir les informations requises à transmettre au client. Lorsque l'application demande à votre service des informations sur la lecture d'un flux en direct, le service doit renvoyer les informations décrites dans le tableau 1.

En particulier, le service doit pouvoir fournir des jetons OAuth aux applications clientes de manière sécurisée. Configurez ce service à l'aide de deux comptes de service, l'un se faisant passer pour l'autre. Un compte de service dispose du rôle Créateur de jetons de service et crée un jeton OAuth pour le compte de service disposant du rôle Utilisateur de l'outil de montage vidéo. Exemple :

  • Compte de service 1: il s'agit du compte de service de l'appelant. Ce compte dispose de l'autorisation Créateur de jetons de service sur le compte de service 2 et usurpe l'identité du compte de service 2 auprès des applications clientes.
  • Compte de service 2: il s'agit du compte de service disposant de privilèges et ayant le rôle Utilisateur de l'outil de montage vidéo pour créer des sessions.

Pour en savoir plus sur la fourniture d'un jeton OAuth à partir de votre service, y compris des exemples de code de bibliothèque cliente, consultez la section Créer un jeton d'accès éphémère.