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 pertinentes dans une vidéo intégrale, plan par plan ou image par image.

Avant de commencer l'atelier

Avant de cliquer sur le bouton Start Lab (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 Start Lab (Démarrer l'atelier), indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique Qwiklabs 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. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Conditions requises

Pour réaliser cet atelier, vous devez :

• avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;
• disposer de suffisamment de temps pour réaliser l'atelier en une fois.

Remarque : Si vous possédez déjà votre propre compte ou projet Google Cloud, veillez à ne pas l'utiliser pour réaliser cet atelier.

Remarque : Si vous utilisez un appareil Chrome OS, exécutez cet atelier dans une fenêtre de navigation privée.

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
   • 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. 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 inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue Se connecter. Cliquez sur Suivant.

4. Copiez le mot de passe inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue de bienvenue. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis dans le panneau de gauche. Ne saisissez pas vos identifiants Google Cloud Skills Boost. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

5. 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 aux essais offerts.

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

Remarque : Vous pouvez afficher le menu qui contient la liste des produits et services Google Cloud en cliquant sur le menu de navigation en haut à gauche.

Activer Google Cloud Shell

Google Cloud Shell est une machine virtuelle qui contient des outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Google Cloud Shell offre un accès en ligne de commande à vos ressources GCP.

1. Dans la console GCP, dans la barre d'outils située en haut à droite, cliquez sur le bouton Ouvrir Cloud Shell.

   

2. Cliquez sur Continue (Continuez):

   

Il faut quelques instants pour mettre en service et se connecter à l'environnement. Lorsque vous êtes connecté, vous êtes déjà authentifié et le projet est défini sur votre PROJECT_ID. Par exemple:

gcloud est l'outil de ligne de commande associé à Google Cloud Platform. Pré-installé sur Cloud Shell, il est également compatible avec la saisie semi-automatique via la touche de tabulation.

Vous pouvez répertorier les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

Résultat :

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

Pour répertorier les ID de projet, exécutez la commande suivante :

gcloud config list project
	

Résultat :

[core]
project = <ID_Projet>
	

Exemple de résultat :

[core]
project = qwiklabs-gcp-44776a13dea667a6
	

Activer l'API Video Intelligence

Pour les besoins de cet atelier, l'API Cloud Video Intelligence est activée.

Configurer les autorisations

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

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

gcloud iam service-accounts create quickstart

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

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

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

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 Check my progress (Vérifier ma progression) pour vérifier l'objectif. Configurer les autorisations

Créer une requête d'annotation vidéo

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 Pour simplifier le processus, vous pouvez utiliser la vidéo publique d'un train disponible pour votre projet Qwiklabs comme valeur pour votre 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".

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 celle-ci :

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

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

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" } ] }, ... }

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": "OPERATION_NAME", "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 Check my progress (Vérifier ma progression) pour vérifier l'objectif. Créer une requête d'annotation vidéo

Félicitations !

Terminer votre quête

Cet atelier d'auto-formation fait partie des quêtes Baseline: Deploy & Develop et Baseline: Data, ML, AI. Une quête est une série d'ateliers associés qui constituent une formation. Si vous terminez cette quête, vous obtiendrez le badge ci-dessus attestant de votre réussite. Vous pouvez rendre publics les badges que vous recevez et ajouter leur lien dans votre CV en ligne ou sur vos comptes de réseaux sociaux. Inscrivez-vous à cette quête pour obtenir immédiatement les crédits associés à cet atelier si vous l'avez suivi. Découvrez les autres quêtes Qwiklabs disponibles.

É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 présenter brièvement les nombreuses fonctionnalités proposées par Google Cloud. Pour suivre un autre atelier, recherchez "Qwik Starts" dans le catalogue.

Google Cloud Training & Certification

...helps you make the most of Google Cloud technologies. Our classes include technical skills and best practices to help you get up to speed quickly and continue your learning journey. We offer fundamental to advanced level training, with on-demand, live, and virtual options to suit your busy schedule. Certifications help you validate and prove your skill and expertise in Google Cloud technologies.

Dernière mise à jour du manuel : 15 juillet 2021

Dernier test de l'atelier : 14 juillet 2021

Copyright 2020 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.