Premiers pas avec l'API Service Management

Cette page décrit comment configurer votre environnement de développement pour qu'il fonctionne avec l'API Service Management. Dans la plupart des cas d'utilisation opérationnels, nous vous recommandons d'utiliser l'API Service Management via la ligne de commande gcloud, qui constitue une alternative tout aussi simple que l'interface utilisateur Web de Google Cloud Console. Si vous devez programmer avec l'API Service Management, nous vous recommandons de choisir l'une des bibliothèques clientes fournies. Pour tester l'API, vous pouvez suivre les instructions de configuration alternative que nous vous proposons ci-dessous et utiliser la commande curl pour vous familiariser avec l'API, sans configurer d'environnement de développement complet.

Remarque : Si vous créez un service à l'aide de Cloud Endpoints, vous devez suivre le Guide de démarrage rapide applicable de Cloud Endpoints. Il fournit des informations sur la configuration et la prise en main de l'API Service Management.

Configurer avec gcloud

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Enable the Service Management API.

   Enable the API

4. Install the Google Cloud CLI.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

7. Enable the Service Management API.

   Enable the API

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

Configurer un appel direct de l'API

Cette section décrit les étapes de base nécessaires à la configuration de votre environnement local pour essayer l'API Service Management avec la commande curl. Ces instructions s'adressent aux développeurs qui ont besoin de programmer avec l'API Service Management.

Configuration initiale

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Enable the Service Management API:

   gcloud services enable servicemanagement.googleapis.com

6. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin

   gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

   • Replace PROJECT_ID with your project ID.

   • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

   • Replace ROLE with each individual role.
7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

10. Enable the Service Management API:

    gcloud services enable servicemanagement.googleapis.com

11. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

    • Replace ROLE with each individual role.

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. Essayez de répertorier les services accessibles au public :

   $ gcurl https://servicemanagement.googleapis.com/v1/services
   

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

Étapes suivantes

Si vous créez un service géré sans utiliser Cloud Endpoints :

1. Suivez les instructions de la page Créer et supprimer des services pour savoir comment procéder. Vous allez ainsi créer une ressource de service géré de niveau supérieur.

2. Suivez les instructions de la page Gérer les configurations de service pour envoyer des configurations de service décrivant les fonctionnalités utilisées par le service.

   Remarque : Les configurations de service ne prennent pas effet après leur envoi. Pour les déployer, rendez-vous à l'étape 3.

3. Pour déployer vos configurations de service, suivez les instructions de la page Déployer des configurations de service.