Avant de commencer

Cette page explique comment configurer un projet Google Cloud et configurer des comptes de service pour y accéder.

Configurer un projet Google Cloud

Suivez ces étapes pour configurer un projet Google Cloud.

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Activer les API Video Stitcher and Live Stream.

   Activer les API

5. Créez un compte de service :

   1. Dans la console Google Cloud, accédez à la page Créer un compte de service.

      Accéder à la page "Créer un compte de service"
   2. Sélectionnez votre projet.

   3. Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.

      Dans le champ Description du compte de service, saisissez une description. Exemple : Service account for quickstart.

   4. Cliquez sur Créer et continuer.

   5. Attribuez les rôles suivants au compte de service : Video Stitcher Admin, Live Stream Editor, Storage Admin.

      Pour attribuer un rôle, trouvez la liste Sélectionner un rôle, puis sélectionnez le rôle.

      Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.

      Remarque : Le champ Rôle détermine les ressources auxquelles le compte de service peut accéder dans votre projet. Vous pouvez révoquer ces rôles ou attribuer des rôles supplémentaires ultérieurement. Dans les environnements de production, n'attribuez pas les rôles Propriétaire, Éditeur et Lecteur. Attribuez plutôt un rôle prédéfini ou un rôle personnalisé répondant à vos besoins.
   6. Cliquez sur Continuer.

   7. Cliquez sur OK pour terminer la création du compte de service.

      Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.

6. Créez une clé de compte de service :

   1. Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
   2. Cliquez sur Keys (Clés).
   3. Cliquez sur Ajouter une clé, puis sur Créer une clé.
   4. Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
   5. Cliquez sur Close (Fermer).

7. Définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS sur le chemin d'accès du fichier JSON contenant vos identifiants. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir.

   Exemple : Linux ou macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

   Par exemple :

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Exemple : Windows

   Pour PowerShell :

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

   Par exemple :

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Pour l'invite de commande :

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

8. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

9. Vérifiez que la facturation est activée pour votre projet Google Cloud.

10. Activer les API Video Stitcher and Live Stream.

    Activer les API

11. Créez un compte de service :

    1. Dans la console Google Cloud, accédez à la page Créer un compte de service.

       Accéder à la page "Créer un compte de service"
    2. Sélectionnez votre projet.

    3. Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.

       Dans le champ Description du compte de service, saisissez une description. Exemple : Service account for quickstart.

    4. Cliquez sur Créer et continuer.

    5. Attribuez les rôles suivants au compte de service : Video Stitcher Admin, Live Stream Editor, Storage Admin.

       Pour attribuer un rôle, trouvez la liste Sélectionner un rôle, puis sélectionnez le rôle.

       Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.

       Remarque : Le champ Rôle détermine les ressources auxquelles le compte de service peut accéder dans votre projet. Vous pouvez révoquer ces rôles ou attribuer des rôles supplémentaires ultérieurement. Dans les environnements de production, n'attribuez pas les rôles Propriétaire, Éditeur et Lecteur. Attribuez plutôt un rôle prédéfini ou un rôle personnalisé répondant à vos besoins.
    6. Cliquez sur Continuer.

    7. Cliquez sur OK pour terminer la création du compte de service.

       Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.

12. Créez une clé de compte de service :

    1. Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
    2. Cliquez sur Keys (Clés).
    3. Cliquez sur Ajouter une clé, puis sur Créer une clé.
    4. Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
    5. Cliquez sur Close (Fermer).

13. Définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS sur le chemin d'accès du fichier JSON contenant vos identifiants. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir.

    Exemple : Linux ou macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

    Par exemple :

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Exemple : Windows

    Pour PowerShell :

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

    Par exemple :

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Pour l'invite de commande :

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

14. Installez Google Cloud CLI.

15. Pour initialiser gcloudCLI, exécutez la commande suivante :

    gcloud init

    Remarque : Vous pouvez exécuter gcloud CLI dans la console Google Cloud sans installer Google Cloud CLI. Pour exécuter gcloud CLI dans la console Google Cloud, utilisez Cloud Shell.
16. Utilisez l'outil gcloud pour tester votre environnement d'authentification. Vérifiez que la commande suivante génère une chaîne de texte sans erreur :

    gcloud auth application-default print-access-token

Activer le compte de service

1. Dans votre terminal, définissez le projet actif pour les commandes gcloud. Remplacez YOUR_PROJECT_ID par votre ID de projet :

   gcloud config set project YOUR_PROJECT_ID
   

2. Activez le compte de service. 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
   

Vous utiliserez ce compte de service pour autoriser l'accès à l'API Video Stitcher et l'appeler.

Associer le compte de service au compte Ad Manager

Une fois le compte de service créé, vous devez l'associer à votre compte Ad Manager. Cela permet à l'API Video Stitcher de créer des événements de diffusion en direct en votre nom. Pour ce faire, procédez comme suit pour accorder l'accès à votre compte de service:

1. Connectez-vous à Google Ad Manager (GAM).
2. Cliquez sur Admin > Paramètres généraux.
3. Assurez-vous que l'accès à l'API est activé.
4. Cliquez sur Ajouter un utilisateur au compte de service.
5. Remplissez le formulaire, y compris l'adresse e-mail du compte de service créé précédemment.
6. Sélectionnez un rôle qui doit inclure l'autorisation Gérer du contenu vidéo avec l'insertion dynamique d'annonces depuis l'assembleur vidéo Google Cloud. Vous devez créer un rôle personnalisé nommé Gestionnaire de diffusion en direct spécialement pour la gestion de ce compte de service. Le rôle personnalisé doit disposer au moins des autorisations suivantes :
   • Gérer le contenu vidéo avec l'insertion dynamique d'annonces depuis Google Cloud Video Stitcher
   • Afficher les créations (requis par l'autorisation précédente)
   • Afficher le contenu, les groupes et les métadonnées des vidéos
   • Afficher les sources de contenu
7. Cliquez sur Enregistrer et confirmez l'ajout du compte de service.

Créer un compte de service avec uniquement les autorisations nécessaires pour créer des sessions

Étant donné qu'un jeton OAuth sera transmis à une application cliente, créez un compte de service distinct doté uniquement des autorisations nécessaires pour créer une session. La fuite d'un jeton OAuth ne peut donc pas compromettre vos ressources, telles que les clés CDN et les événements de diffusion en direct.

Créez un compte de service :

1. Dans la console Google Cloud, accédez à la page Créer un compte de service.

   Accéder à la page "Créer un compte de service"
2. Sélectionnez votre projet.

3. Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.

   Dans le champ Description du compte de service, saisissez une description. Exemple : Service account for quickstart.

4. Cliquez sur Créer et continuer.

5. Attribuez les rôles suivants au compte de service : Video Stitcher User.

   Pour attribuer un rôle, trouvez la liste Sélectionner un rôle, puis sélectionnez le rôle.

   Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.

   Remarque : Le champ Rôle détermine les ressources auxquelles le compte de service peut accéder dans votre projet. Vous pouvez révoquer ces rôles ou attribuer des rôles supplémentaires ultérieurement. Dans les environnements de production, n'attribuez pas les rôles Propriétaire, Éditeur et Lecteur. Attribuez plutôt un rôle prédéfini ou un rôle personnalisé répondant à vos besoins.
6. Cliquez sur Continuer.

7. Cliquez sur OK pour terminer la création du compte de service.

   Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.

Créez une clé de compte de service :

1. Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
2. Cliquez sur Keys (Clés).
3. Cliquez sur Ajouter une clé, puis sur Créer une clé.
4. Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
5. Cliquez sur Close (Fermer).