Cette page a été traduite par l'API Cloud Translation.
Switch to English

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. Accédez à la page Bibliothèque d'API de Google Cloud Console.
    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.

Configurer l'autorisation

Pour autoriser l'API Service Usage à accéder à votre projet Cloud, procédez comme suit:

  1. Créer un compte de service
    1. Accédez à la page Comptes de service de Cloud Console.
      Accéder à la page Comptes de service
    2. Sélectionnez 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.
  2. Attribuez le rôle Administrateur d'utilisation du service à votre nouveau compte de service. Pour savoir comment attribuer des rôles aux comptes de service, consultez la page Attribuer des rôles aux comptes de service.
  3. Configurez votre machine locale.

    1. Accédez à la page Identifiants de l'API de Cloud Console.
      Accéder à la page "Identifiants"
    2. 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 compte de service, consultez la page Créer et gérer les clés de comptes de service.
    3. Installez oauth2l sur votre ordinateur local, de façon à pouvoir interagir avec le système Google OAuth.
    4. Vous pouvez également utiliser oauth2l pour créer un jeton de support à l'aide de votre fichier d'identifiants. pour vérifier que votre configuration OAuth est correcte et que le fichier d'identifiants de votre compte de service est valide:

          oauth2l header --json ~/credentials.json cloud-platform userinfo.email
      

      En cas de réussite, la sortie ressemble à ce qui suit:

          Authorization: Bearer y29.xxxxxxx
      

Tester avec curl

  1. 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"'
    
  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 votre 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.