Configurer Service Usage pour un environnement de développement

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

  • Dans la plupart des cas d'utilisation opérationnels, le moyen le plus simple d'activer et de désactiver des services consiste à utiliser la console Google Cloud.
  • Si vous avez besoin de créer des scripts, vous pouvez utiliser Google Cloud CLI.
  • 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 Google Cloud pour lequel vous souhaitez l'utiliser:

  1. Accédez à la page Bibliothèque d'API de la console Google Cloud.
    Accédez à la page Bibliothèque d'API
  2. Sélectionnez le projet Google 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 "Authorization: Bearer $(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. Il peut s'agir de l'ID ou du numéro du projet:

    PROJECT_ID="my-project-id"

  3. Vérifiez que vous êtes connecté à "gcloud" :

    gcloud auth login

  4. Répertoriez les API et les services activés dans ce projet :

    gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_ID}/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

Suivez Listing Services (Répertorier les services) pour répertorier les API et les services activés ou disponibles dans vos projets Google Cloud.