Cette section présente les étapes à suivre pour intégrer votre application à Cloud Marketplace. En règle générale, vous intégrez votre application à Google Cloud en appliquant l'une des méthodes suivantes :
Intégration du backend
Vous devez intégrer le backend de votre application aux API et services Google suivants :
Intégrez Pub/Sub pour 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 sur 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 associer le compte de l'utilisateur dans votre produit à son compte Google, et également pour Identity and Access Management (IAM).
Fournissez une page de connexion à vos clients.
Vous pouvez également:
- 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 SSO, lorsque les utilisateurs se connectent à l'aide de l'authentification SSO, Google envoie un jeton Web JSON (JWT) contenant des informations sur l'utilisateur que vous devez 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.
Avant de commencer
- Vérifiez si votre ingénieur partenaire a bien activé l'accès à l'API Partner Procurement de 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 des API Google
Vous pouvez intégrer votre application aux API Google à l'aide de bibliothèques clientes, qui 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 méthode build(). Pour obtenir un exemple de code permettant de créer une bibliothèque client, consultez les exemples de l'atelier de programmation sur GitHub.