Avant de commencer

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

Configurer un Google Cloud projet

Suivez ces étapes pour configurer un Google Cloud projet.

Connectez-vous à votre Google Cloud compte. 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 sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Video Stitcher API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

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

   Go to Create service account
3. Select your project.

4. 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.

5. Click Create and continue.

6. 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.
7. Click Continue.

8. 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.

Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

Example: Linux or macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

Example: Windows

For PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

For command prompt:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Replace KEY_PATH with the path of the JSON file that contains your credentials.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Video Stitcher API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

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

   Go to Create service account
3. Select your project.

4. 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.

5. Click Create and continue.

6. 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.
7. Click Continue.

8. 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.

Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

Example: Linux or macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

Example: Windows

For PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

For command prompt:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Replace KEY_PATH with the path of the JSON file that contains your credentials.

1. Installez la Google Cloud CLI.

2. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

3. Pour initialiser la gcloud CLI, exécutez la commande suivante :

   gcloud init

   Remarque : Vous pouvez exécuter la Google gcloud CLI dans la Google Cloud console sans l'installer. Pour exécuter la gcloud CLI dans la Google Cloud console, utilisez Cloud Shell.
4. 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 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 et appeler l'API Video Stitcher.

Créer un compte de service avec uniquement les autorisations permettant de créer des sessions

Étant donné qu'un jeton OAuth sera transmis à une application cliente, créez un compte de service distinct avec uniquement les autorisations permettant de créer une session. Ainsi, un jeton OAuth divulgué ne pourra pas compromettre vos ressources, telles que les configurations VOD/en direct ou les clés CDN.

Créez un compte de service :

1. Assurez-vous de disposer du rôle IAM Créateur de comptes de service (roles/iam.serviceAccountCreator) et du rôle IAM Administrateur de projet (roles/resourcemanager.projectIamAdmin). Découvrez comment attribuer des rôles.

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

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

4. Dans le champ Nom du compte de service, saisissez un nom. La Google Cloud console 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.

5. Cliquez sur Créer et continuer.

6. Attribuez le rôle Utilisateur de Video Stitcher au compte de service.

   Pour accorder le rôle, trouvez la liste Sélectionner un rôle, puis sélectionnez Utilisateur de Video Stitcher.

   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.
7. Cliquez sur Continuer.

8. 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 Google Cloud console, 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 Fermer.

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 VOD).

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'accès à l'API est activé.
4. Cliquez ensuite 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 dans 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 disposer au moins des autorisations suivantes :
   • Gérer le contenu vidéo avec l'insertion dynamique d'annonces dans l'assembleur vidéo Google Cloud
   • Afficher les créations (requis par l'autorisation précédente)
   • Afficher le contenu, les groupes et les métadonnées associés aux vidéos
   • Afficher les sources de contenu
7. Si votre réseau Ad Manager utilise des équipes, vous devez attribuer l'équipe "Toutes les entités" à l'utilisateur du compte de service.
8. Cliquez sur Enregistrer et 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 compatibles (consultez les exigences concernant le fichier manifeste source). Cette procédure est facultative. Vous pouvez utiliser votre propre diffusion en direct.

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 utiliser le 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 diffusion en direct.

Veillez à ce que la diffusion en direct reste active. Ne suivez pas les étapes de la section Nettoyer tant que vous n'avez pas 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 en fonction du format.

HLS

• Le format de conteneur peut être l'un des suivants :
  • MPEG-TS multiplexé
  • MPEG-TS non multiplexé
  • FMP4 non multiplexé
• Au moins une version dans le fichier manifeste avec les champs suivants (correctement renseignés) :
  • codecs
  • bandwidth

MPEG-DASH

• MPD@type défini sur dynamic (@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 VOD

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

Créer les fichiers sources VOD

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