GSP154

Présentation

Google Cloud Video Intelligence permet d'inclure des vidéos dans l'index de recherche et d'améliorer leur visibilité en extrayant leurs métadonnées à l'aide d'une API REST facile à utiliser. Vous pouvez désormais rechercher n'importe quel moment dans tous les fichiers vidéo de votre catalogue. L'API annote rapidement les vidéos stockées dans Cloud Storage, puis vous aide à en identifier des entités clés (noms) et les moments où celles-ci apparaissent. Vous pouvez séparer le signal du bruit en récupérant des informations appropriées dans une vidéo intégrale, plan par plan ou image par image.

Objectifs de l'atelier

Dans cet atelier, vous allez apprendre à effectuer les tâches suivantes :

• Configurer les autorisations pour un compte de service personnalisé
• Envoyer une requête d'annotation vidéo à l'API Video Intelligence

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre vous-même les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Nous vous fournissons des identifiants temporaires pour vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

• vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;

Remarque : Ouvrez une fenêtre de navigateur en mode incognito/navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le temporaire étudiant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

• vous disposez d'un temps limité ; une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.

Remarque : Si vous possédez déjà votre propre compte ou projet Google Cloud, veillez à ne pas l'utiliser pour réaliser cet atelier afin d'éviter que des frais supplémentaires ne vous soient facturés.

Démarrer l'atelier et se connecter à la console Google Cloud

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, un pop-up s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau Détails concernant l'atelier, qui contient les éléments suivants :

   • Le bouton Ouvrir la console Google Cloud
   • Le temps restant
   • Les identifiants temporaires que vous devez utiliser pour cet atelier
   • Des informations complémentaires vous permettant d'effectuer l'atelier

2. Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).

   L'atelier lance les ressources, puis ouvre la page Se connecter dans un nouvel onglet.

   Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

   Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.

3. Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.

   {{{user_0.username | "Username"}}}

   Vous trouverez également le nom d'utilisateur dans le panneau Détails concernant l'atelier.

4. Cliquez sur Suivant.

5. Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.

   {{{user_0.password | "Password"}}}

   Vous trouverez également le mot de passe dans le panneau Détails concernant l'atelier.

6. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

7. Accédez aux pages suivantes :

   • Acceptez les conditions d'utilisation.
   • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
   • Ne vous inscrivez pas à des essais gratuits.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Pour afficher un menu contenant la liste des produits et services Google Cloud, cliquez sur le menu de navigation en haut à gauche.

Activer Cloud Shell

Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Cloud Shell vous permet d'accéder via une ligne de commande à vos ressources Google Cloud.

1. Cliquez sur Activer Cloud Shell  en haut de la console Google Cloud.

Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET. Le résultat contient une ligne qui déclare YOUR_PROJECT_ID (VOTRE_ID_PROJET) pour cette session :

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud est l'outil de ligne de commande pour Google Cloud. Il est préinstallé sur Cloud Shell et permet la complétion par tabulation.

2. (Facultatif) Vous pouvez lister les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

3. Cliquez sur Autoriser.

4. Vous devez à présent obtenir le résultat suivant :

Résultat :

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Facultatif) Vous pouvez lister les ID de projet à l'aide de cette commande :

gcloud config list project

Résultat :

[core] project = <ID_Projet>

Exemple de résultat :

[core] project = qwiklabs-gcp-44776a13dea667a6 Remarque : Pour consulter la documentation complète sur gcloud, dans Google Cloud, accédez au guide de présentation de la gcloud CLI.

Tâche 1 : Configurer les autorisations

Pour cet atelier, vous allez créer et utiliser un compte de service dont les autorisations dépendent de votre projet Google Cloud.

1. Dans Cloud Shell, exécutez la commande suivante pour créer un compte de service nommé quickstart :

gcloud iam service-accounts create quickstart

2. Créez un fichier de clé de compte de service en remplaçant <your-project-123> par l'ID de votre projet :

gcloud iam service-accounts keys create key.json --iam-account quickstart@<your-project-123>.iam.gserviceaccount.com

3. Maintenant, connectez-vous à votre compte de service en indiquant l'emplacement du fichier de la clé :

gcloud auth activate-service-account --key-file key.json

4. Procurez-vous un jeton d'autorisation à l'aide de votre compte de service :

gcloud auth print-access-token

Le jeton s'affiche dans les résultats. Il vous sera utile dans une prochaine étape.

Cliquez sur Vérifier ma progression pour valider l'objectif. Configurer les autorisations

Tâche 2 : Créer une requête d'annotation vidéo

Remarque : L'API Cloud Video Intelligence est déjà activée pour vous dans cet atelier.

1. Exécutez cette commande pour créer un fichier de requête JSON avec le texte suivant, puis enregistrez-le sous le nom request.json :

cat > request.json <<EOF { "inputUri":"gs://spls/gsp154/video/train.mp4", "features": [ "LABEL_DETECTION" ] } EOF Remarque : Pour simplifier le processus, la vidéo publique d'un train disponible pour votre projet est utilisée comme valeur pour votre commande inputUri. Si vous préférez, ou si vous exécutez un projet personnel, vous pouvez utiliser n'importe quelle vidéo en l'important dans Cloud Storage et en fournissant son URI Cloud Storage (format : `gs://bucket/object`) pour la valeur inputUri.

2. Exécutez la commande curl pour effectuer une requête videos:annotate dans laquelle vous transmettez le nom de fichier de la requête d'entité :

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/videos:annotate' \ -d @request.json

L'API Video Intelligence crée une opération pour traiter votre requête. Vous devez à présent obtenir une réponse incluant le nom de l'opération. Cette réponse doit se présenter comme suit :

{ "name": "projects/474887704060/locations/asia-east1/operations/16366331060670521152" }

Vous utiliserez ce nom d'opération, les emplacements et les projets à l'étape suivante.

3. Demandez des informations sur l'opération à l'aide du script ci-dessous en appelant le point de terminaison v1.operations. Remplacez PROJECTS, LOCATIONS et OPERATION_NAME par les valeurs que vous venez de recevoir dans la commande précédente :

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/projects/PROJECTS/locations/LOCATIONS/operations/OPERATION_NAME'

Des informations sur votre opération s'affichent à présent. Si celle-ci est terminée, un champ done est ajouté et défini sur true :

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.Annota tionProgressMetadata", "progressMetadata": [ { "inputUri": "gs://spls/gsp154/video/train.mp4", "startTime": "2016-09-22T21:41:56.766091Z", "lastUpdateTime": "2016-09-22T21:42:03.889743Z" } ] }, ... }

4. Après avoir laissé un certain temps à la requête (une minute en général), exécutez de nouveau la commande. La même requête renvoie les résultats d'annotation :

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "/spls/gsp154/video/train.mp4", "progressPercent": 100, "startTime": "2017-02-17T22:39:00.333942Z", "updateTime": "2017-02-17T22:39:11.414399Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse", "annotationResults": [ { "inputUri": "/spls/gsp154/video/train.mp4", "segmentLabelAnnotations": [ { "entity": { "entityId": "/m/01yrx", "languageCode": "en-US" }, "segments": [ { "segment": { "startTimeOffset": "0s", "endTimeOffset": "14.833664s" }, "confidence": 0.98509187 } ] }, ...

Vous avez envoyé votre première requête à l'API Cloud Video Intelligence.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une requête d'annotation vidéo

Félicitations !

Vous avez envoyé une requête d'annotation vidéo à l'API Video Intelligence et reçu les résultats.

Étapes suivantes et informations supplémentaires

Cet atelier fait partie d'une série appelée "Qwik Starts". Les ateliers de cette série sont conçus pour vous donner un aperçu des nombreuses fonctionnalités proposées par Google Cloud. Pour suivre un autre atelier, recherchez "Qwik Starts" dans le catalogue Google Cloud Skills Boost.

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 4 février 2024

Dernier test de l'atelier : 22 décembre 2023

Copyright 2024 Google LLC Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.