Avant que tu commences

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

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

4. Activez Video Stitcher API.

   Activer l'API

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Video Stitcher Admin role to the service account.

      To grant the role, find the Select a role list, then select Video Stitcher Admin.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

6. Create a service account key:

   1. In the Google Cloud console, click the email address for the service account that you created.
   2. Click Keys.
   3. Click Add key, and then click Create new key.
   4. Click Create. A JSON key file is downloaded to your computer.
   5. Click Close.

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

10. Activez Video Stitcher API.

    Activer l'API

11. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

       Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

       In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Video Stitcher Admin role to the service account.

       To grant the role, find the Select a role list, then select Video Stitcher Admin.

       Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
    6. Click Continue.

    7. Click Done to finish creating the service account.

       Do not close your browser window. You will use it in the next step.

12. Create a service account key:

    1. In the Google Cloud console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.

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 la gcloud CLI 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 l'ID de votre 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
   

Ce compte de service vous permettra d'autoriser l'accès et d'appeler l'API Video Stitcher.

Créer un compte de service disposant uniquement des 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 disposant uniquement des autorisations nécessaires pour créer une session. Par conséquent, un jeton OAuth divulgué ne peut pas compromettre vos ressources, telles que les configurations en direct/à la demande ou les clés CDN.

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the Video Stitcher User role to the service account.

   To grant the role, find the Select a role list, then select Video Stitcher User.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
6. Click Continue.

7. Click Done to finish creating the service account.

   Do not close your browser window. You will use it in the next step.

Create a service account key:

1. In the Google Cloud console, click the email address for the service account that you created.
2. Click Keys.
3. Click Add key, and then click Create new key.
4. Click Create. A JSON key file is downloaded to your computer.
5. Click Close.

Configuration de la diffusion en direct

Si vous insérez des annonces dans une diffusion en direct, suivez les étapes de cette section (ou consultez les étapes pour la vidéo à la demande).

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, suivez les étapes permettant d'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'option Accès à l'API est activée.
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 le contenu vidéo avec l'insertion dynamique d'annonces à partir de l'assembleur vidéo Google Cloud. Vous devez créer un rôle personnalisé nommé Gestionnaire de diffusion en direct spécifiquement pour la gestion de ce compte de service. Le rôle personnalisé doit au moins disposer des autorisations suivantes :
   • Gérer le contenu vidéo avec l'insertion dynamique d'annonces à partir de Google Cloud Video Stitcher
   • Afficher les créations (requis au titre de l'autorisation précédente)
   • Afficher le contenu, les groupes et les métadonnées vidéo
   • Afficher les sources de contenu
7. Cliquez sur Enregistrer, puis confirmez l'ajout du compte de service.

Créer une diffusion en direct

Vous pouvez utiliser l'un des guides de démarrage rapide de l'API Live Stream pour configurer une diffusion en direct. Les diffusions en direct HLS et MPEG-DASH sont toutes deux compatibles (consultez les exigences concernant les fichiers manifestes sources). Cette procédure est facultative. Vous pouvez utiliser votre propre diffusion en direct existante.

Les guides de démarrage rapide de l'API Live Stream utilisent les identifiants par défaut de l'application pour l'authentification, mais vous pouvez vous servir du compte de service que vous avez déjà configuré. Pour cette option, assurez-vous que le compte de service dispose du rôle Éditeur de flux en direct.

Assurez-vous que la diffusion en direct reste active. Ne suivez pas les étapes de la section Effectuer un nettoyage avant d'avoir terminé la diffusion en direct.

Exigences concernant le fichier manifeste source

L'API Video Stitcher enregistre la configuration auprès d'Ad Manager en analysant le fichier manifeste source. Le fichier manifeste source doit présenter certaines caractéristiques selon le format.

HLS

• Le format du conteneur peut être :
  • MPEG-TS muxed
  • MPEG-TS non muxed
  • FMP4 non muxed
• Au moins un rendu dans le fichier manifeste avec les champs suivants (correctement renseignés) :
  • codecs
  • bandwidth

MPEG-DASH

• "MPD@type" définie sur "dynamique" (@type="dynamic")
• MPD@profiles inclut le profil ISO Live urn:mpeg:dash:profile:isoff-live:2011
• Doit être multipériode, chaque période contenant un ou plusieurs ensembles d'adaptation
• Chaque ensemble d'adaptation contient une ou plusieurs représentations
• Les représentations contiennent ou héritent d'un SegmentTemplate avec l'identifiant $Number$ ou $Time$.
• @segmentAlignment défini sur "true" pour tous les ensembles d'adaptation
• Les représentations ne doivent pas être vides

Configuration du flux de vidéo à la demande

Si vous insérez des annonces dans un flux de vidéo à la demande, suivez les étapes de cette section (ou consultez les étapes pour une diffusion en direct).

Créer les fichiers sources de la vidéo à la demande

Ce workflow nécessite un fichier manifeste MPEG-DASH (MPD) ou HLS (HTTP Live Streaming) (M3U8), ainsi que les fichiers segments associés. Vous pouvez utiliser vos propres fichiers VOD existants ou créer des fichiers sources VOD à l'aide de l'API Transcoder.