Cette page vous explique comment configurer un projet Google Cloud et des comptes de service pour y accéder.
Configurer un Google Cloud projet
Suivez ces étapes pour configurer un Google Cloud projet.
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Video Stitcher API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
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
. - Click Create and continue.
-
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.
- Click Continue.
-
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:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- 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. -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Video Stitcher API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
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
. - Click Create and continue.
-
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.
- Click Continue.
-
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:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- 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. - Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Utilisez la CLI 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
- 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
- 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 ne disposant que des autorisations nécessaires pour créer une session. Ainsi, un jeton OAuth divulgué ne peut pas compromettre vos ressources, telles que les configurations VOD/en direct ou les clés CDN.
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
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
. - Click Create and continue.
-
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.
- Click Continue.
-
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:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- 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 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 la procédure permettant d'accorder l'accès à votre compte de service:
- Connectez-vous à Google Ad Manager (GAM).
- Cliquez sur Admin > Paramètres généraux.
- Assurez-vous que l'accès aux API est activé.
- Cliquez ensuite sur Ajouter un utilisateur au compte de service.
- Remplissez le formulaire, y compris l'adresse e-mail du compte de service créé précédemment.
- 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 diffusions 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
- Si votre réseau Ad Manager utilise des équipes, vous devez attribuer l'équipe "Toutes les entités" à l'utilisateur du compte de service.
- 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 acceptées (voir les exigences concernant les fichiers manifestes sources). Cette procédure est facultative. Vous pouvez utiliser votre propre diffusion en direct existante.
Les démarrages rapides 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.
Assurez-vous de laisser la diffusion en direct active. Ne suivez pas les étapes de la section Nettoyage 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 du conteneur peut être :
- MPEG-TS multiplexé
- MPEG-TS non multiplexé
- FMP4 non multiplexé
- Au moins une interprétation dans le fichier manifeste avec les champs suivants (correctement renseignés) :
- codecs
- bandwidth
MPEG-DASH
MPD@type
défini sur dynamique (@type="dynamic"
)MPD@profiles
inclut le profil en direct ISOurn:mpeg:dash:profile:isoff-live:2011
- Doit être multipériodique, 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 de contenus 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 segments associés. Vous pouvez utiliser vos propres fichiers VOD existants ou créer des fichiers sources VOD à l'aide de l'API Transcoder.