Intégrer votre application à Google Cloud Marketplace

Cette section décrit les étapes à suivre pour intégrer votre application à Cloud Marketplace. En règle générale, vous intégrez votre application à Google Cloud par les moyens suivants :

• Intégration du backend

  Vous devez intégrer le backend de votre application aux API et services Google suivants :

  • L'intégration à Pub/Sub permet de recevoir des notifications de Cloud Marketplace, par exemple lorsqu'un utilisateur s'inscrit à votre produit. Votre ingénieur partenaire crée un sujet Pub/Sub auquel vous devez vous abonner pour recevoir des notifications.

    Pour plus d'informations sur l'abonnement à un thème Pub/Sub, consultez le Guide de l'abonné Pub/Sub.

  • Intégrez à l'API Partner Procurement pour créer des comptes pour les clients et associez ces comptes à leur achat Cloud Marketplace. Vous devez également utiliser l'API Partner Procurement pour mettre à jour les comptes liés lorsque les utilisateurs modifient ou annulent leurs formules d'abonnement.

  • Si vous avez choisi un modèle de tarification basé sur l'utilisation, intégrez-le à l'API Service Control pour créer des rapports sur les informations d'utilisation.

  Pour en savoir plus sur l'intégration du backend de votre application à Cloud Marketplace, consultez la section Configurer le backend de votre application.

  Pour obtenir un exemple d'intégration du backend d'un produit de base à Cloud Marketplace et un tutoriel pour l'exemple de code, consultez l'atelier de programmation pour intégrer un produit SaaS.

• Intégration de l'interface

  Dans l'interface de votre application, vous devez configurer les intégrations suivantes :

  • Fournissez une page d'inscription pour les nouveaux clients qui achètent votre produit via Cloud Marketplace. Lorsque les utilisateurs accèdent à cette page, Google envoie un jeton Web JSON (JWT) contenant l'ID de compte de l'utilisateur. Vous utilisez cet ID de compte pour lier le compte de l'utilisateur dans votre produit à son compte Google, ainsi que pour Identity and Access Management (IAM).

    Remarque : Un même utilisateur peut avoir plusieurs Google Cloud ID de compte, ou plusieurs utilisateurs peuvent partager un Google Cloud ID de compte commun, selon la façon dont ils ou leur organisation ont configuré leur utilisation de Google Cloud.

  • Fournissez une page de connexion à vos clients.

  Vous pouvez également choisir d'effectuer les opérations suivantes :

  • Intégrez l'authentification unique (SSO) afin que vos clients puissent se connecter à votre application à l'aide de leur compte Google. Si vous intégrez l'authentification unique, lorsque les utilisateurs se connectent à l'aide de cette méthode, Google vous envoie un jeton Web JSON (JWT) contenant des informations sur l'utilisateur que vous pouvez vérifier.

  Pour en savoir plus sur l'intégration de l'interface de votre application à Cloud Marketplace, consultez la section Intégrer l'interface de votre application.

Si vous utilisez App Lifecycle Manager pour déployer et exploiter votre produit SaaS, vous pouvez également profiter d'une validation simplifiée et d'une intégration des locataires en un clic. Pour en savoir plus, consultez la section Intégrer App Lifecycle Manager.

Avant de commencer

• Vérifiez si votre ingénieur partenaire a bien activé l'accès à l' API partenaire Procurement pour Cloud Commerce. Une fois que votre ingénieur partenaire vous a accordé l'accès à l'API Partner Procurement, vous n'avez pas besoin de suivre d'autres étapes pour activer l'API dans la console Google Cloud .

Intégrer une application aux API Google

Vous pouvez intégrer votre application aux API Google à l'aide de bibliothèques clientesqui vous permettent d'accéder par programme aux produits Google. Elles sont disponibles pour les plates-formes de développement les plus courantes, telles que Java, Python et .NET.

Installez les bibliothèques clientes de votre plate-forme à partir de la page Bibliothèques clientes d'API. Avec les bibliothèques clientes, vous pouvez :

• vous connecter à votre abonnement Pub/Sub et gérer les messages entrants.
• vous connecter à l'API Service Control pour transmettre les données d'utilisation à Google, si vous avez choisi la tarification basée sur l'utilisation.

Pour créer des comptes liés pour les clients, et pour envoyer et recevoir des mises à jour sur les comptes utilisateur, vous devez également intégrer l'API Partner Procurement. L'accès à cette API étant limité, vous devez créer une bibliothèque cliente.

Pour ce faire, vous devez d'abord installer les bibliothèques clientes Google, puis créer une bibliothèque à partir du document de découverte de l'API accessible à l'adresse suivante :

https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1

Par exemple, si vous créez une bibliothèque cliente Python pour l' API Partner Procurement, utilisez la build() méthode. Pour obtenir un exemple de code permettant de créer une bibliothèque client, consultez les exemples de l'atelier de programmation sur GitHub.