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 Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de 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

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

    Accéder au sélecteur de projet

  6. 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.

  7. Activez l'API Cloud Vision.

    Activer l'API

Créer un bucket Cloud Storage

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

    Accéder à la page du navigateur

  2. Cliquez sur Créer un bucket.
  3. Sur la page Créer un bucket, saisissez les informations concernant votre bucket. Pour passer à l'étape suivante, cliquez sur Continuer.
    • Pour nommer votre bucket, saisissez un nom unique. N'incluez aucune information sensible dans le nom des buckets, car leur espace de noms est global et visible par tous.
    • Pour Choisir l'emplacement de stockage des données, procédez comme suit :
      • Sélectionnez une option de type d'emplacement.
      • Sélectionnez une option Emplacement.
    • Pour Choisir une classe de stockage par défaut pour vos données, sélectionnez les éléments suivants : Standard.
    • Pour le champ Choisir comment contrôler l'accès aux objets, sélectionnez une option de Contrôle des accès.
    • Sous Paramètres avancés (facultatif), choisissez une méthode de chiffrement, une règle de conservation ou des libellés 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'APIs Explorer 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. Le corps de la requête doit se présenter comme suit :

    {
      "requests": [
        {
          "features": [
            {
              "type": "LABEL_DETECTION"
            }
          ],
          "image": {
            "source": {
              "imageUri": "gs://cloud-samples-data/vision/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