GSP277

Aperçu

Google API Explorer est un outil permettant d'explorer différentes API Google de façon interactive. Grâce à API Explorer, vous pouvez :

• parcourir rapidement les API et les versions disponibles ;
• consulter les méthodes disponibles pour chaque API, les paramètres compatibles, ainsi que la documentation intégrée ;
• exécuter des requêtes pour chaque méthode et voir les réponses en temps réel ;
• effectuer des appels d'API authentifiés et autorisés ;
• effectuer des recherches dans l'ensemble des services, des méthodes et de vos requêtes récentes afin de trouver rapidement ce dont vous avez besoin.

API Explorer utilise sa propre clé API à chaque requête. Lorsque vous l'utilisez pour faire une requête, API Explorer affiche la syntaxe de la requête, qui inclut un espace réservé portant le libellé {YOUR_API_KEY}. Si vous souhaitez réaliser la même requête dans votre application, vous devez remplacer cet espace réservé par votre propre clé API.

Objectifs de l'atelier

• Créer un bucket Cloud Storage

• Importer une image dans Cloud Storage et la rendre publique

• Envoyer une requête à l'API Vision avec cette image

Configuration et prérequis

Configuration de Qwiklabs

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.

Créer un bucket Cloud Storage

1. Dans la console Cloud, accédez à Storage > Browser (Stockage > Navigateur).

2. Cliquez sur Create bucket (Créer un bucket).

3. Attribuez un nom unique à votre bucket. N'incluez aucune information sensible dans le nom des buckets, car leur espace de noms est global et visible par tous.

4. Cliquez sur Choose how to control access to objects et sélectionnez le cercle Fine-grained:

5. Cliquez sur Create (Créer).

Tester la tâche terminée

Cliquez sur Check my progress (Vérifier ma progression) pour vérifier votre tâche exécutée. Si votre tâche a bien été exécutée, vous recevez une note d'évaluation.

Créez un bucket Cloud Storage.

Importer une image

Vous allez demander à l'API Cloud Vision d'analyser une image via API Explorer. Tout d'abord, ajoutez une image à votre bucket pour l'analyser. Vous pouvez utiliser l'une de vos images ou télécharger celle ci-dessous sur votre ordinateur et l'enregistrer avec le nom demo-image.jpg.

Dans votre bucket, cliquez sur Upload Files (Importer des fichiers) et sélectionnez le fichier demo-image.jpg que vous avez enregistré.

Tester la tâche terminée

Cliquez sur Check my progress (Vérifier ma progression) pour vérifier votre tâche exécutée. Si votre tâche a bien été exécutée, vous recevez une note d'évaluation.

Importez une image dans un bucket de stockage (demo-image.jpg).

Une fois le fichier importé et répertorié dans votre bucket, rendez l'image publique en procédant comme suit :

1. Cliquez sur le menu à trois points associé à votre image.

2. Dans le menu déroulant, sélectionnez Edit permissions (Modifier les autorisations).

3. Dans la fenêtre qui apparaît en superposition, cliquez sur le bouton + Add entry.

4. Ajoutez une autorisation pour allUsers.

5. Sélectionnez Public pour le champ Entity (Entité).

6. Saisissez allUsers pour le champ Name (Nom).

7. Sélectionnez Reader (Lecture) pour le champ Access (Accès).

8. Cliquez sur Save (Enregistrer).

Tester la tâche terminée

Cliquez sur Check my progress (Vérifier ma progression) pour vérifier votre tâche exécutée. Si votre tâche a bien été exécutée, vous recevez une note d'évaluation.

Rendez l'image téléchargée accessible au public.

L'image doit être publique désormais. Vous êtes prêt à utiliser API Explorer.

Envoyer une requête au service de l'API Cloud Vision

Accédez au menu de navigation > APIs & Services (API et services).

Dans la barre de recherche, tapez Cloud Vision et sélectionnez l'API Cloud Vision dans la liste des résultats, puis cliquez dessus.

Assurez-vous que cette API est activée, sinon cliquez sur Activer(Enable). Maintenant que vous avez vérifié l'activation de l'API, ouvrez ce lien. Cela ouvrira un nouvel onglet avec la page Explorateur d'API chargée.

Vous êtes redirigé vers la page API Explorer.

1. Cliquez à l'intérieur des accolades dans le champ du corps de la requête. Vous êtes invité à sélectionner une propriété : choisissez "requests". Cette action permet de passer à l'étape suivante. Cliquez à l'intérieur des crochets et cliquez sur l'icône de signe plus bleu, sélectionnez [Add Item](Ajouter un élément)- pour votre propriété, sélectionnez "features".
2. Dans "features", cliquez à l'intérieur de l'accolade, puis sur le signe plus bleu et sélectionnez [Add Item](Ajouter un élément), Sélectionnez "type" et indiquez LABEL_DETECTION à côté.
3. Une zone "add property" doit s'afficher dans "features". Vous pouvez choisir d'y ajouter "image", ainsi que "source" et "imageUri". En regard de "imageUri", saisissez le chemin d'accès à votre fichier image dans le bucket. Le chemin d'accès doit ressembler à ce qui suit : gs://MY_BUCKET/demo-image.jpg
4. Lorsque vous avez terminé, le champ du corps de votre requête doit être comme suit :

5. Assurez-vous que les cases à cocher Google OAuth 2.0 et Clé API sont sélectionnées dans la section Informations d'identification.

6. Sur le panneau de droite d'une console API Explorer, vous pouvez voir l'appel de l'API Cloud Vision avec cURL, HTTP et JAVASCRIPT.
7. Maintenant, cliquez sur Exécuter.

Sélectionnez le compte étudiant avec lequel vous avez commencé l'atelier.

Sur l'écran suivant, cliquez sur Allow (Autoriser) pour permettre à API Explorer d'accéder aux informations.

Les résultats de l'analyse de l'image par l'API Cloud Vision apparaissent en dessous de votre requête. La partie supérieure des résultats doit ressembler à l'exemple suivant :

Tester vos connaissances

Voici quelques questions à choix multiples qui vous permettront de mieux maîtriser les concepts abordés lors de cet atelier. Répondez-y du mieux que vous le pouvez.

Félicitations !

Vous avez envoyé votre première requête images.annotate au service de l'API Cloud Vision.

Terminer votre quête

Cet atelier d'auto-formation fait partie de la quête Qwiklabs Exploring APIs et Intro to ML: Image Processing. Une quête est une série d'ateliers associés qui constituent une formation. Si vous terminez cette quête, vous obtenez 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.

Suivre votre prochain atelier

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 trouver le prochain atelier que vous aimeriez suivre, recherchez "Qwik Starts" dans le catalogue.

Étapes suivantes et informations supplémentaires

• Consulter la page des questions fréquentes sur API Explorer
• Découvrir l'API Cloud Vision.

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 : 23 mars 2021

Dernier test de l'atelier : 23 mars 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.