Premiers pas

Cette page explique comment configurer votre environnement de développement pour utiliser l'API Service Usage.

  • Pour la plupart des cas d'utilisation opérationnels, la manière la plus simple d'activer et de désactiver des services consiste à utiliser Google Cloud Console.
  • Si vous devez créer des scripts, vous pouvez utiliser l'interface de ligne de commande gcloud.
  • Si vous devez programmer à l'aide de l'API Service Usage, utilisez l'une des bibliothèques clientes.
  • Pour tester l'API, vous pouvez suivre les instructions de configuration alternative de ce guide et utiliser la commande curl pour tester l'API sans configurer un environnement de développement d'application complet.

Configurer un appel direct de l'API

Cette section décrit les étapes de base nécessaires à la configuration de votre environnement local pour tester l'API Service Usage à l'aide de la commande curl. Elle s'adresse aux développeurs qui ont besoin de programmer à l'aide de l'API Service Usage.

Activer l'API Service Usage

Pour utiliser l'API Service Usage, vous devez d'abord l'activer dans le projet Cloud avec lequel vous souhaitez l'utiliser :

  1. Dans Google Cloud Console, accédez à la page Bibliothèque d'API.
    Accédez à la page Bibliothèque d'API
  2. Cliquez sur Sélectionner pour choisir le projet Cloud que vous souhaitez utiliser pour accéder au service.
  3. Sur la page "Bibliothèque d'API", cliquez sur Activer.

Créer un compte de service

Créez un compte de service et une clé pour exécuter les commandes curl dans cette section :

  1. Dans Cloud Console, accédez à la page Comptes de service.
    Accéder à la page Comptes de service
  2. Cliquez sur Sélectionner pour choisir le projet Cloud que vous souhaitez utiliser pour accéder au service.
  3. Créer un compte de service Pour savoir comment créer des comptes de service, consultez la page Créer et gérer un compte de service. Pour suivre les instructions de cette section, vous devez attribuer le rôle roles/serviceusage.serviceUsageAdmin au compte de service. Pour savoir comment attribuer un rôle à un compte de service, consultez la page Attribuer des rôles aux comptes de service.
  4. Dans Cloud Console, accédez à la page Identifiants de l'API.
    Aller à la page des Identifiants de l'API.
  5. Créez une clé de compte de service pour votre nouveau compte de service et téléchargez son fichier d'identifiants JSON sur votre ordinateur local. Les exemples de ce guide partent du principe que le chemin d'accès du fichier est ~/credentials.json. Pour savoir comment créer des clés de comptes de service, consultez la page Créer et gérer des clés de comptes de service.
  6. Installez oauth2l sur votre ordinateur local, de façon à pouvoir interagir avec le système Google OAuth.

Tester avec curl

  1. Vérifiez d'abord votre configuration initiale :

    oauth2l header --json ~/credentials.json cloud-platform
    
  2. Une fois le flux OAuth terminé, le résultat doit ressembler à celui-ci :

    Authorization: Bearer y29.xxxxxxx
    
  3. Définissez un alias d'interface système pratique pour appeler les API REST de Google :

    alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -H "Content-Type: application/json"'
    
  4. Essayez de répertorier les API, ainsi que les services disponibles et activés dans un projet :

    gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services
    

    Si vous voyez une liste de services, le processus de configuration a réussi.

Étapes suivantes

Pour répertorier les API et les services activés ou disponibles dans vos projets Cloud, consultez la page Répertorier les services.