Préparer votre application cliente à utiliser 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 d'éléments VOD :

ChampDescription
projectNumberNuméro de projet Google Cloud (PROJECT_NUMBER) utilisé pour créer des sessions compatibles avec Ad Manager. Vous pouvez également utiliser l'ID de projet.
region Emplacement (LOCATION) que vous souhaitez que le SDK IMA utilise pour créer la session VOD.
vodConfigIdLa ID de configuration VOD utilisé pour enregistrer le flux de vidéo à la demande avec l'API Video Stitcher. Voici le format du nom complet de la ressource de configuration :
projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID
L'ID de configuration VOD est la dernière partie du nom complet (VOD_CONFIG_ID). N'oubliez pas que l'emplacement de la configuration doit être le même que celui où vous créez la session VOD.
networkCodeIdentifiant numérique (NETWORK_CODE) pour à 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. Voir Générer des jetons OAuth de courte durée

Table 1. Informations requises pour les sessions d'éléments vidéo à la demande compatibles avec Ad Manager

Générer des jetons OAuth de courte durée à des fins de test

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, consultez la section suivante des informations sur la création d'un service de production pour fournir des jetons de courte durée.

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 manière lire un élément VOD, le service doit renvoyer les informations décrites dans l'article Tableau 1.

En particulier, le service doit pouvoir fournir des jetons OAuth des applications clientes de manière sécurisée. Configurez ce service à l'aide de deux services un compte en usurpant l'identité de l'autre Un compte de service dispose du rôle Créateur de jetons de service et crée un compte pour le compte de service ayant le rôle Utilisateur d'assembleur 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 des privilèges Utilisateur d'assembleur vidéo pour créer des sessions.

Pour plus d'informations sur la fourniture d'un jeton OAuth à partir de votre service, y compris le client des exemples de code de bibliothèque, consultez Créez un jeton d'accès de courte durée.