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'outil 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. Sélectionnez le projet Cloud que vous souhaitez utiliser pour accéder au service.
  3. Sur la page "Bibliothèque d'API", cliquez sur Activer.
  4. Assurez-vous que votre compte utilisateur dispose du rôle Administrateur Service Usage.

Tester avec curl

  1. Définissez un alias d'interface système pratique pour appeler les API REST de Google :

    alias gcurl='curl -H "$(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
  2. Définissez une variable d'environnement PROJECT_ID avec l'identifiant de votre projet :

    PROJECT_ID="my-project-id"
    
  3. Vérifiez que vous êtes connecté à "gcloud" :

    gcloud auth login
    
  4. Utilisez gcloud pour trouver le numéro de votre projet et enregistrez-le dans une variable d'environnement :

    PROJECT_NUMBER=`gcloud projects list --filter="${PROJECT_ID}" --format="value(PROJECT_NUMBER)"`
    
  5. Répertoriez les API et les services activés dans ce projet :

    gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED&fields=services.config.title,services.config.name"
    

    Si vous obtenez un résultat semblable à celui-ci, cela signifie que la configuration a réussi :

    {
    "services": [
      {
        "config": {
          "name": "bigquery.googleapis.com",
          "title": "BigQuery API"
        }
      },
      {
        "config": {
          "name": "bigquerystorage.googleapis.com",
          "title": "BigQuery Storage API"
        }
      },
      ...
    

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