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. L'approche la plus simple pour utiliser l'API Service Management (autre que l'interface utilisateur Web de la console Google Cloud), et notre recommandation pour la plupart des cas d'utilisation opérationnels, consiste à passer par l'interface de ligne de commande gcloud. 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 de Cloud Endpoints pour apprendre à configurer et à utiliser l'API Service Management pour Cloud Endpoints.

Configurer avec gcloud

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

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Activez l'API Service Management

   Activer l'API

4. Installez Google Cloud CLI.

5. Pour initialiser gcloudCLI, exécutez la commande suivante :

   gcloud init

6. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

7. Activez l'API Service Management

   Activer l'API

8. Installez Google Cloud CLI.

9. Pour initialiser gcloudCLI, exécutez la commande suivante :

   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. 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.
2. Installez Google Cloud CLI.

3. Pour initialiser gcloudCLI, exécutez la commande suivante :

   gcloud init

4. Créez ou sélectionnez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   • Créez un projet Google Cloud :

     gcloud projects create PROJECT_ID

     Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

   • Sélectionnez le projet Google Cloud que vous avez créé :

     gcloud config set project PROJECT_ID

     Remplacez PROJECT_ID par le nom de votre projet Google Cloud.

5. Activer l'API Service Management :

   gcloud services enable servicemanagement.googleapis.com

6. Attribuez des rôles à votre compte Google. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants : roles/servicemanagement.admin

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

   • en remplaçant PROJECT_ID par l'ID de votre projet :
   • Remplacez EMAIL_ADDRESS par votre adresse e-mail.
   • Remplacez ROLE par chaque rôle individuel.
7. Installez Google Cloud CLI.

8. Pour initialiser gcloudCLI, exécutez la commande suivante :

   gcloud init

9. Créez ou sélectionnez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   • Créez un projet Google Cloud :

     gcloud projects create PROJECT_ID

     Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

   • Sélectionnez le projet Google Cloud que vous avez créé :

     gcloud config set project PROJECT_ID

     Remplacez PROJECT_ID par le nom de votre projet Google Cloud.

10. Activer l'API Service Management :

    gcloud services enable servicemanagement.googleapis.com

11. Attribuez des rôles à votre compte Google. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants : roles/servicemanagement.admin

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

    • en remplaçant PROJECT_ID par l'ID de votre projet :
    • Remplacez EMAIL_ADDRESS par votre adresse e-mail.
    • Remplacez ROLE par chaque rôle individuel.

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