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.

Configurer avec gcloud

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

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

    Accéder à la page de sélection du projet

  3. Activez l'API Service Management.

    Activer l'API

  4. Installez et initialisez le SDK Cloud.

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. Accédez à la page Comptes de service de Cloud Console.
    Accéder à la page Comptes de service
  2. Cliquez sur Sélectionner pour choisir le projet Google 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. Pour suivre les instructions de cette section, vous devez attribuer le rôle roles/servicemanagement.admin au compte de service. Pour savoir comment attribuer un rôle à un compte de service, consultez la page Attribuer des rôles aux comptes de service.
  4. Accédez à la page Identifiants d'API de Cloud Console.
    Accéder à la page Identifiants d'API
  5. 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 supposent que le chemin 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 des clés de compte de service.
  6. Installez oauth2l sur votre ordinateur local, de façon à pouvoir interagir avec le système Google OAuth.

Tester avec curl

  1. Vérifiez d'abord votre configuration initiale :

    $ oauth2l header --json ~/credentials.json cloud-platform
    
  2. Une fois le flux OAuth terminé, vous devriez obtenir un résultat comme celui-ci :

    Authorization: Bearer y29.xxxxxxx
    
  3. 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)" -H "Content-Type: application/json"'
    
  4. Essayez de répertorier les services accessibles au public :

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

    Si vous obtenez 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.

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