Utiliser l'explorateur d'API

Ce guide de démarrage rapide vous guide tout au long des processus suivants :

  • Créer un bucket Cloud Storage
  • Importer votre image sur Cloud Storage et la rendre publique
  • Envoyer une requête à l'API Vision avec cette image

Ces étapes devraient durer environ 5 minutes. Vous pouvez stocker gratuitement jusqu'à 5 Go de données dans Cloud Storage et envoyer gratuitement jusqu'à 1 000 requêtes de fonctionnalités par mois à l'API Cloud Vision.

Avant de commencer

Si vous ne l'avez pas déjà fait, configurez votre projet et créez un bucket Google Cloud Storage, comme expliqué ci-dessous.

Configurer votre projet

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder à la page de sélection du projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez l'API Cloud Vision.

    Activer l'API

Créer un bucket Cloud Storage

  1. Dans Cloud Console, accédez à la page Navigateur Cloud Storage.

    Accéder au navigateur Cloud Storage

  2. Cliquez sur Créer un bucket.
  3. Dans la boîte de dialogue Créer un bucket, spécifiez les attributs suivants :
    • Name : nom de bucket unique. N'incluez aucune information sensible dans le nom des buckets, car leur espace de noms est global et visible par tous.
    • Classe de stockage par défaut: Standard
    • Emplacement de stockage des données de bucket.
  4. Cliquez sur Create (Créer).

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

  1. Téléchargez demo-img.jpg. (Vous devrez peut-être cliquer avec le bouton droit de la souris sur le lien.)

  2. Ouvrez le navigateur de stockage Cloud Console.

  3. Sélectionnez le bucket que vous avez créé dans la section précédente.

  4. Cliquez sur Importer des fichiers et sélectionnez le fichier demo-img.jpg à importer dans le bucket Cloud Storage à partir de votre machine locale.

    Voici le fichier image que vous venez d'importer :
    image montrant des femmes faisant du vélo à Jakarta
    Crédit image : Rohiim Ariful sur Unsplash.

  5. Une fois le fichier importé et répertorié dans le navigateur Cloud Storage, partagez l'image en mode public.

  6. Complétez le modèle interactif d'explorateur d'API ci-dessous en remplaçant cloud-samples-data/vision dans le champ image.source.imageUri par le nom du bucket Cloud Storage dans lequel vous avez importé le fichier demo-img.jpg.

  7. Cliquez sur Exécuter pour envoyer la requête au service. La réponse JSON s'affiche au-dessus.

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

Nettoyer

Pour éviter d'encourir des frais inutiles liés à Google Cloud Platform, supprimez le bucket Cloud Storage (et le projet) à l'aide de Cloud Console si vous n'en avez plus besoin.

Étape suivante