GSP421

Présentation

Google APIs Explorer est un outil permettant d'explorer différentes API Google de façon interactive. APIs Explorer vous permet d'effectuer les opérations suivantes :

• Parcourir rapidement les API et les versions disponibles
• Consulter les méthodes disponibles dans 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 APIs Explorer pour exécuter des requêtes API dans 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'APIs Explorer
• Importer des fichiers image dans votre bucket Cloud Storage
• Copier un fichier image et l'ajouter à un bucket Cloud Storage à l'aide d'APIs Explorer
• Supprimer des fichiers image de votre bucket Cloud Storage à l'aide d'APIs Explorer
• Supprimer un bucket Cloud Storage à l'aide d'APIs Explorer

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.

Tâche 1 : Créer des buckets Cloud Storage

1. Pour accéder à l'outil APIs Explorer de Cloud Storage, ouvrez le menu de navigation et sélectionnez API et services > Bibliothèque.

2. Dans la barre de recherche, saisissez Cloud Storage.

3. Cliquez sur Google Cloud Storage JSON API (API JSON de Google Cloud Storage) dans la liste des résultats.

4. Assurez-vous que l'API est activée. Si ce n'est pas le cas, cliquez sur Activer.

5. Ouvrez la méthode Buckets: insert reference. La page APIs Explorer s'ouvre dans un nouvel onglet.

Vous êtes maintenant sur la page APIs Explorer.

Remarque : Dans la section suivante, vous utiliserez la méthode insert de l'API JSON Cloud Storage. Vous pouvez consulter toutes les versions de l'API et les méthodes associées dans la documentation de référence de l'API.

6. Cliquez maintenant sur le corps de la requête dans le panneau de droite sous "Essayer cette API", puis renseignez les informations concernant votre bucket de stockage :

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

Votre méthode doit désormais être semblable à celle-ci :

Remarque : Assurez-vous que le champ d'ID de projet ne se termine pas par une espace. Vérifiez également que les options Google OAuth 2.0 et Clé API sont cochées dans la section Identifiants.

Remarque : Pour afficher les questions fréquentes sur les identifiants, cliquez sur l'icône en forme de point d'interrogation à côté du titre Identifiants.

7. Cliquez sur le bouton Exécuter.

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

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

La réponse doit être semblable à celle-ci :

{ "kind": "storage#bucket", "id": "qwiklabs-bucket01", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket01", "projectNumber": "250399850182", "name": "qwiklabs-bucket01", "timeCreated": "2019-10-18T13:59:08.300Z", "updated": "2019-10-18T13:59:08.300Z", "metageneration": "1", "iamConfiguration": { "bucketPolicyOnly": { "enabled": false }, "uniformBucketLevelAccess": { "enabled": false } }, "location": "US", "locationType": "multi-region", "storageClass": "STANDARD", "etag": "CAE=" }

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer un bucket Cloud Storage

Tâche 2 : Créer un deuxième bucket Cloud Storage

Créez maintenant un autre bucket Cloud Storage. Vous pourrez ainsi vous entraîner à copier des fichiers entre les deux buckets.

1. Toujours dans la méthode insert, assurez-vous que l'ID de votre projet se trouve encore dans le champ du projet.

2. Dans le corps de la requête, pour la paire clé/valeur name (nom), attribuez un nom unique à votre deuxième bucket.

3. Vérifiez qu'aucun champ ne se termine par une espace.

4. Cliquez sur le bouton Exécuter. La réponse doit être semblable à celle-ci :

{ "kind": "storage#bucket", "id": "qwiklabs-bucket02", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket02", "projectNumber": "250399850182", "name": "qwiklabs-bucket02", "timeCreated": "2019-10-18T13:59:08.300Z", "updated": "2019-10-18T13:59:08.300Z", "metageneration": "1", "iamConfiguration": { "bucketPolicyOnly": { "enabled": false }, "uniformBucketLevelAccess": { "enabled": false } }, "location": "US", "locationType": "multi-region", "storageClass": "STANDARD", "etag": "CAE=" }

Vous avez réussi à créer deux buckets à l'aide de la méthode insert. Vous allez maintenant les retrouver dans la console Cloud.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer un deuxième bucket Cloud Storage

Afficher vos buckets Cloud Storage dans la console Cloud

1. Revenez à la console Cloud. Dans le menu de navigation, accédez à Cloud Storage pour vérifier que vos buckets Cloud Storage ont bien été créés.

2. Dans le menu de navigation, sélectionnez Cloud Storage > Buckets. Les buckets que vous venez de créer doivent s'afficher.

Restez dans la console Cloud pour l'étape suivante. Gardez l'onglet APIs Explorer ouvert.

Tâche 3 : Importer des fichiers dans votre bucket Cloud Storage

Importez quelques fichiers dans votre bucket Cloud Storage afin de vous familiariser avec les méthodes intégrées à APIs Explorer.

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

2. Enregistrez maintenant cette image du domaine public représentant Ada Lovelace sur votre ordinateur et nommez-la demo-image2.png :

3. Dans le navigateur Cloud Storage, sélectionnez le premier bucket de la liste.

4. Cliquez sur Upload files (Importer des fichiers) et sélectionnez demo-image1.png et demo-image2.png sur votre ordinateur.

Les deux fichiers image doivent avoir été ajoutés au bucket, lequel doit désormais ressembler à ceci :

Cliquez sur Vérifier ma progression pour valider l'objectif. Importer des fichiers dans votre bucket Cloud Storage (demo-image1.png et demo-image2.png)

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

Tâche 4 : Copier des fichiers entre des buckets Cloud Storage

1. Dans la section "API et documentation de référence" à gauche, accédez à API JSON > Documentation de référence de l'API > Objets > copier pour utiliser la méthode copy. Pour copier des fichiers entre des buckets de stockage à l'aide d'APIs Explorer, vous pouvez aussi utiliser la méthode Objects: copy reference.

2. Apportez les modifications suivantes :

• 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 doit ressembler à celle-ci :

3. Assurez-vous que les cases Google OAuth 2.0 et Clé API sont cochées dans la section Identifiants.

Remarque : Pour afficher les questions fréquentes sur les identifiants, cliquez sur l'icône en forme de point d'interrogation à côté du titre Identifiants.

4. Vérifiez qu'aucun champ ne se termine par une espace.

5. Maintenant, faites défiler la page vers le bas et cliquez sur Exécuter.

Vous devez obtenir un résultat semblable à celui-ci :

{ "kind": "storage#object", "id": "qwiklabs-bucket02/demo-image1-copy.png/1571408245199237", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket02/o/demo-image1-copy.png", "name": "demo-image1-copy.png", "bucket": "qwiklabs-bucket02", "generation": "1571408245199237", "metageneration": "1", "contentType": "image/png", "timeCreated": "2019-10-18T14:17:25.198Z", "updated": "2019-10-18T14:17:25.198Z", "storageClass": "STANDARD", "timeStorageClassUpdated": "2019-10-18T14:17:25.198Z", "size": "401951", "md5Hash": "LbpHpwhnApQKQx9IEXjTsQ==", "mediaLink": "https://www.googleapis.com/download/storage/v1/b/qwiklabs-bucket02/o/demo-image1-copy.png?generation=1571408245199237&alt=media", "owner": { "entity": "user-gcpstaging93416_student@qwiklabs.net" }, "crc32c": "j5oPrg==", "etag": "CIWjgvL/peUCEAE=" }

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

Cliquez sur Vérifier ma progression pour valider l'objectif. Copier des fichiers entre des buckets Cloud Storage (demo-image1-copy.png)

Afficher votre bucket mis à jour dans la console Cloud

1. Revenez à la console Cloud pour cette étape. Vous devriez être resté sur la page d'informations de votre bucket Cloud Storage.

2. Dans le menu de gauche, cliquez sur Buckets et sélectionnez votre deuxième bucket. La copie du fichier demo-image1.png doit désormais s'afficher ici.

Tâche 5 : Supprimer des fichiers d'un bucket Cloud Storage

1. Dans la section "API et documentation de référence" à gauche, accédez à API JSON > Documentation de référence de l'API > Objets > supprimer. Pour supprimer des fichiers d'un bucket Cloud Storage à l'aide d'APIs Explorer, vous pouvez aussi utiliser la méthode Objects: delete reference.

2. 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 doit ressembler à celle-ci :

3. Assurez-vous que les cases Google OAuth 2.0 et Clé API sont cochées dans la section Identifiants.

Remarque : Pour afficher les questions fréquentes sur les identifiants, cliquez sur l'icône en forme de point d'interrogation à côté du titre Identifiants.

4. Vérifiez qu'aucun champ ne se termine par une espace.

5. Maintenant, faites défiler la page vers le bas et cliquez sur Exécuter.

Vous devez obtenir un résultat semblable au suivant :

6. 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 doit ressembler à celle-ci :

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

Vous venez de supprimer des fichiers d'un bucket à l'aide de la méthode objects.delete. Vous allez maintenant vérifier que les fichiers ont été supprimés dans la console Cloud.

Afficher votre bucket mis à jour dans la console Cloud

1. Revenez à la console Cloud pour cette étape. Vous devriez être resté sur la page d'informations de votre bucket Cloud Storage.

2. Dans le menu de gauche, cliquez sur Buckets et sélectionnez votre premier bucket. Vous devez constater que les deux images ont bien été supprimées.

Tâche 6 : Supprimer votre bucket Cloud Storage

1. Dans la section "API et documentation de référence" à gauche, accédez à API JSON > Documentation de référence de l'API > Buckets > supprimer pour utiliser la méthode buckets.delete. Pour supprimer un bucket Cloud Storage à l'aide d'APIs Explorer, vous pouvez aussi utiliser la méthode Buckets: delete reference.

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

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

3. Assurez-vous que les cases Google OAuth 2.0 et Clé API sont cochées dans la section Identifiants.

Remarque : Pour afficher les questions fréquentes sur les identifiants, cliquez sur l'icône en forme de point d'interrogation à côté du titre Identifiants.

4. Vérifiez qu'aucun champ ne se termine par une espace.

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

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

Afficher votre bucket mis à jour dans la console Cloud

1. Revenez à la console Cloud pour cette étape. Vous devriez être resté sur la page d'informations de votre bucket.

2. Dans le menu de gauche, cliquez sur Buckets. Vous pouvez constater que votre premier bucket a été supprimé.

Vous avez terminé toutes les étapes de cet atelier. Vous pouvez mettre fin à l'atelier ou utiliser le temps restant pour tester de nouvelles méthodes.

Tâche 7 : 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 avez créé des buckets Cloud Storage avec APIs Explorer. Vous avez également copié et supprimé des fichiers image avec des méthodes spécifiques d'APIs Explorer. Après avoir supprimé des fichiers image, 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'APIs Explorer.

Terminer votre quête

Cet atelier d'auto-formation fait partie de la quête Exploring APIs. Une quête est une série d'ateliers associés qui constituent un parcours de formation. Si vous terminez cette quête, vous obtenez un badge 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. Découvrez toutes les quêtes disponibles dans le catalogue Google Cloud Skills Boost.

Étapes suivantes et informations supplémentaires

Pour améliorer vos connaissances pratiques sur APIs Explorer, suivez cet atelier :

API Explorer : Créer et mettre à jour un cluster

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 : 1er mai 2023

Dernier test de l'atelier : 8 février 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.