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.
Configurer avec gcloud
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Service Management API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Service Management API.
- Install the Google Cloud CLI.
-
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
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud 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.
-
-
Enable the Service Management API:
gcloud services enable servicemanagement.googleapis.com
-
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_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud 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.
-
-
Enable the Service Management API:
gcloud services enable servicemanagement.googleapis.com
-
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_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
Tester avec curl
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"'
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 :
- 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.
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.
Pour déployer vos configurations de service, suivez les instructions de la page Déployer des configurations de service.