GSP421

Aperçu

Google API Explore est un outil permettant d'explorer différentes API Google de façon interactive. Avec API Explore, vous pouvez :

• parcourir rapidement les API et les versions disponibles ;
• découvrir les méthodes disponibles pour chaque API, les paramètres compatibles, ainsi que la documentation en ligne ;
• 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.

Cloud Storage vous permet de stocker et de récupérer autant de données que vous le souhaitez, à tout moment et à l'échelle mondiale. Vous pouvez utiliser Cloud Storage dans diverses situations, par exemple : diffuser le contenu d'un site Web, stocker des données pour l'archivage et la reprise après sinistre ou distribuer des objets de données volumineux aux utilisateurs via le téléchargement direct.

Dans cet atelier, vous allez utiliser API Explore pour exécuter des requêtes avec l'API Cloud Storage afin de créer et supprimer des buckets Cloud Storage. Vous apprendrez également à copier et à supprimer des fichiers dans Cloud Storage.

Objectifs

Au cours de cet atelier, vous allez apprendre à réaliser les opérations suivantes :

• Créer des buckets Cloud Storage à l'aide d'API Explore
• Importer des fichiers images dans votre bucket Cloud Storage
• Copier un fichier image et l'ajouter à un bucket Cloud Storage à l'aide d'API Explore
• Supprimer des fichiers images de votre bucket Cloud Storage à l'aide d'API Explore
• Supprimer un bucket Cloud Storage à l'aide d'API Explore

Prérequis

Cet atelier s'adresse aux utilisateurs de niveau intermédiaire. Il suppose une connaissance de l'architecture et du fonctionnement de base des API. Une expérience préalable de Cloud Shell et des outils d'interface de ligne de commande est recommandée.

Il est recommandé de savoir utiliser API Explore et Cloud Storage. Par conséquent, veuillez commencer par suivre au moins les ateliers ci-dessous :

• API Explore : Qwik Start
• Cloud Storage : Qwik Start – Console

Lorsque vous êtes prêt, faites défiler la page vers le bas pour passer à la configuration de l'atelier.

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.

Console Google Cloud Platform

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 des buckets Cloud Storage

Pour accéder à l'outil API Explore de Cloud Storage, ouvrez le menu de navigation et sélectionnez APIs & Services > Library (API et services > Bibliothèque) :

Dans la barre de recherche, saisissez Cloud Storage. Cliquez sur Google Cloud Storage JSON API (API JSON de Google Cloud Storage) dans la liste des résultats.

Assurez-vous que API est activé, sinon cliquez sur Activer. Maintenant que vous avez vérifié l'activation de l'API, ouvrez ce lien. Un nouvel onglet s'ouvrira avec la page APIs Explorer chargée.

Vous allez maintenant être sur la page APIs Explorer.

Remarque: dans la section ci-dessous, nous utilisons la méthode d'insert de l' de Google Cloud Storage JSON API. Vous pouvez afficher toutes les versions d'API et leur méthode sur le lien Google Cloud Storage JSON API.

Maintenant, cliquez sur le Request body dans le panneau de droite sous Try this API et renseignez les détails de votre compartiment storage:

• project (Projet) : ajoutez l'ID de votre projet GCP.
• Request body (Corps de la requête) : cliquez entre les guillemets situés à côté de la paire valeur/clé name (nom) et donnez un nom unique à votre bucket Cloud Storage respectant les consignes relatives à l'attribution d'un nom aux buckets Cloud Storage.

Votre méthode devrait être semblable à celle-ci :

Remarque: Assurez-vous qu'il n'y a pas d'espaces de fin dans les champs. Assurez-vous que les cases à cocher Google OAuth 2.0 et API key sont sélectionnées dans la Credentials Section

Remarque: pour consulter la FAQ sur les Credentials, cliquez sur l'icône en forme de point d'interrogation en regard du titre des Credentials.

Cliquez sur le bouton Execute (Exécuter).

Sélectionnez votre compte Google Qwiklabs, puis cliquez sur Allow (Autoriser).

Votre réponse devrait être semblable à celle-ci :

{
"kind": "storage#bucket",
"id": "qwiklabs-bucket-01",
"selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket-001",
"projectNumber": "791748860803",
"name": "qwiklabs-bucket-01",
"timeCreated": "2018-11-29T20:53:14.695Z",
"updated": "2018-11-29T20:53:14.695Z",
"metageneration": "1",
"iamConfiguration": {
 "bucketPolicyOnly": {
  "enabled": false
 }
},
"location": "US",
"storageClass": "STANDARD",
"etag": "CAE="
}

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.

Créer un deuxième bucket Cloud Storage

Créez maintenant un autre bucket Cloud Storage pour vous familiariser avec la copie de fichiers entre les deux buckets.

Toujours dans la méthode insert, assurez -vous que l'ID de votre projet Qwiklabs GCP se trouve toujours dans le champ du projet. Dans le corps de la requête, pour la paire valeur/clé name (nom), attribuez un nom unique à votre deuxième bucket.

Assurez-vous qu'il n'y a pas d'espaces de fin dans les champs. Cliquez sur le bouton Execute (Exécuter). Votre réponse devrait être semblable à celle-ci :

{
"kind": "storage#bucket",
"id": "qwiklabs-bucket-02",
"selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket-001",
"projectNumber": "791748860803",
"name": "qwiklabs-bucket-02",
"timeCreated": "2018-11-29T20:53:14.695Z",
"updated": "2018-11-29T20:53:14.695Z",
"metageneration": "1",
"iamConfiguration": {
 "bucketPolicyOnly": {
  "enabled": false
 }
},
"location": "US",
"storageClass": "STANDARD",
"etag": "CAE="
}

Vous venez de créer deux buckets avec la méthode insert. Vous allez maintenant les retrouver dans la console GCP.

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 deuxième bucket Cloud Storage.

Afficher vos buckets Cloud Storage dans la console GCP

Revenez à la console GCP et ouvrez le menu de navigation pour vous assurer que vos buckets Cloud Storage ont bien été créés.

Dans le menu de navigation, sélectionnez Storage > Browser (Stockage > Navigateur). Les buckets que vous venez de créer devraient s'afficher :

Restez dans la console GCP pour l'étape suivante. Gardez l'onglet API Explore ouvert.

Importer des fichiers dans votre bucket Cloud Storage

Vous allez maintenant importer quelques fichiers dans votre bucket Cloud Storage afin de vous familiariser avec les méthodes intégrées à API Explore.

Enregistrez l'image suivante sur votre ordinateur et nommez-la demo-image1.png :

Enregistrez maintenant cette image du domaine public d'Ada Lovelace sur votre ordinateur et nommez-la demo-image2.png :

Dans le navigateur Cloud Storage, sélectionnez le premier bucket de la liste. Cliquez sur Upload files (Importer des fichiers) et sélectionnez demo-image1.png et demo-image2.png sur votre ordinateur. Les deux fichiers images doivent avoir été ajoutés au bucket qui doit désormais ressembler à ceci :

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 des fichiers dans votre bucket Cloud Storage (demo-image1.png et demo-image2.png)

Vous allez maintenant copier un des fichiers images dans votre deuxième bucket Cloud Storage.

Copier des fichiers entre des buckets Cloud Storage

Dans la section APIs et références de gauche, accédez à JSON API > API reference > Objects > copy à copy méthode ou utilisez ce lien pour copier des fichiers entre les compartiments storage à l'aide de API Explorer.

• sourceBucket : saisissez le nom du bucket contenant les fichiers demo-image.
• sourceObject : saisissez demo-image1.png.
• destinationBucket : saisissez le nom de votre deuxième bucket (vide).
• destinationObject : saisissez demo-image1-copy.png. La méthode qui s'affiche doit ressembler à celle-ci :

Assurez-vous que les cases à cocher Google OAuth 2.0 et API key sont sélectionnées dans la Credentials Section

Remarque: pour consulter la FAQ sur les Credentials, cliquez sur l'icône en forme de point d'interrogation en regard du titre des Credentials.

Assurez-vous qu'il n'y a pas d'espaces de fin dans les champs. Maintenant, faites défiler la page vers le bas et cliquez sur Execute (Exécuter). Vous devriez obtenir un résultat semblable à celui-ci :

{
"kind": "storage#object",
"id": "qwiklabs-bucket-02/demo-image1-copy.png/1543541268626690",
"selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket-02/o/demo-image1-copy.png",
"name": "demo-image1-copy.png",
"bucket": "qwiklabs-bucket-02",
"generation": "1543541268626690",
"metageneration": "1",
"contentType": "image/png",
"timeCreated": "2018-11-30T01:27:48.626Z",
"updated": "2018-11-30T01:27:48.626Z",
"storageClass": "STANDARD",
"timeStorageClassUpdated": "2018-11-30T01:27:48.626Z",
"size": "401951",
"md5Hash": "LbpHpwhnApQKQx9IEXjTsQ==",
"mediaLink": "https://www.googleapis.com/download/storage/v1/b/qwiklabs-bucket-02/o/demo-image1-copy.png?generation=1543541268626690&alt=media",
"owner": {
 "entity": "user-gcpstaging27201_student@qwiklabs.net"
},
"crc32c": "j5oPrg==",
"etag": "CIL6jKj7+t4CEAE="
}

Vous venez de copier un fichier d'un bucket à un autre à l'aide de la méthode storage.buckets.copy.

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.

Copiez des fichiers entre des buckets Cloud Storage (demo-image1-copy.png)

Afficher votre bucket mis à jour dans la console GCP

Revenez à la console GCP pour cette étape. Vous devriez être resté sur la page d'informations de votre bucket Cloud Storage. Dans le menu de gauche, cliquez sur Browser (Navigateur) et sélectionnez votre deuxième bucket. La copie du fichier demo-image1.png devrait s'afficher :

Supprimer des fichiers d'un bucket Cloud Storage

Dans la section APIs et références de gauche, accédez à JSON API > API reference > Objects > delete ou utilisez ce lien pour supprimer des fichiers d'un Cloud Storage bucket à l'aide de API Explorer.

Vous allez maintenant supprimer un fichier image d'un bucket Cloud Storage.

• bucket : saisissez le nom du bucket contenant les deux fichiers demo-image.
• object (Objet) : saisissez demo-image1.png. La méthode qui s'affiche doit ressembler à celle-ci :

Assurez-vous que les cases à cocher Google OAuth 2.0 et API key sont sélectionnées dans la Credentials Section

Remarque: pour consulter la FAQ sur les Credentials, cliquez sur l'icône en forme de point d'interrogation en regard du titre des Credentials.

Assurez-vous qu'il n'y a pas d'espaces de fin dans les champs. Maintenant, faites défiler la page vers le bas et cliquez sur Execute (Exécuter). Vous devriez obtenir un résultat semblable à celui-ci :

Supprimez maintenant la deuxième image du bucket Cloud Storage. Toujours dans la même méthode, dans le champ object (objet), saisissez demo-image2.png. Le nom de votre bucket demeurera inchangé. La méthode qui s'affiche doit ressembler à celle-ci :

Maintenant, faites défiler la page vers le bas et cliquez sur Execute (Exécuter). Vous devriez obtenir un résultat semblable à celui-ci :

Vous venez de supprimer des fichiers d'un bucket à l'aide de la méthode delete. Vous allez maintenant afficher le fichier supprimé dans la console GCP.

Afficher votre bucket mis à jour dans la console GCP

Revenez à la console GCP pour cette étape. Vous devriez être resté sur la page d'informations de votre bucket Cloud Storage. Dans le menu de gauche, cliquez sur Browser (Navigateur) et sélectionnez votre premier bucket. Vous devriez voir que les deux images ont été supprimées :

Supprimer votre bucket Cloud Storage

Dans la section APIs et références de gauche, accédez à JSON API > API reference > Buckets > delete à buckets.delete méthode ou utilisezce lien pour supprimer un Cloud Storage bucket à l'aide de API Explorer.

Vous allez maintenant supprimer votre premier bucket Cloud Storage (vide).

Dans le champ bucket, saisissez le nom de votre premier bucket. La méthode qui s'affiche doit ressembler à celle-ci :

Assurez-vous que les cases à cocher Google OAuth 2.0 et API key sont sélectionnées dans la Credentials Section

Remarque: pour consulter la FAQ sur les Credentials, cliquez sur l'icône en forme de point d'interrogation en regard du titre des Credentials.

Assurez-vous qu'il n'y a pas d'espaces de fin dans les champs. Maintenant, faites défiler la page vers le bas et cliquez sur Execute (Exécuter). Vous devriez obtenir un résultat semblable à celui-ci :

Vous venez de supprimer un bucket à l'aide de la méthode storage.buckets.delete.

Afficher votre bucket mis à jour dans la console GCP

Revenez à la console GCP pour cette étape. Vous devriez être resté sur la page d'informations de votre bucket. Dans le menu de gauche, cliquez sur Browser (Navigateur). Vous devriez voir que votre premier bucket a été supprimé :

Vous avez terminé toutes les étapes de cet atelier. Vous pouvez terminer votre atelier ou utiliser le temps restant pour tester de nouvelles méthodes.

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 !

Dans cet atelier, vous vous êtes entraîné à créer des buckets Cloud Storage avec API Explore. Vous avez ensuite appris à copier et à supprimer des fichiers images à l'aide de méthodes spécifiques à API Explore. Après avoir supprimé des fichiers images, vous avez appris à supprimer un bucket entier à l'aide de la méthode delete. À ce stade, vous avez une bonne maîtrise de Cloud Storage et savez comment utiliser les méthodes de ce service par le biais d'API Explore.

Terminer votre quête

Cet atelier d'auto-formation fait partie de la quête Qwiklabs Exploring APIs. 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.

Étapes suivantes et informations supplémentaires

Pour améliorer vos connaissances pratiques sur API Explore, consultez les ateliers suivants :

• API Explore : IoT

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 : 28 novembre 2019

Dernier test de l'atelier : 28 novembre 2019

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.