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.
Effectuez l'intégration avec l'API Partner Procurement afin de créer des comptes pour clients et d'associer ces comptes à leur compte Cloud Marketplace à l'achat. 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 Service Control pour générer 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 Intégrer le backend de votre application.
Pour un exemple d'intégration du backend d'un produit de base avec Cloud Marketplace et suivez un tutoriel de l'exemple de code, consultez la atelier de programmation sur l'intégration d'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 créer des comptes pour les nouveaux clients qui achètent votre 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 compte utilisateur dans votre produit avec son compte Google, et aussi pour Identity and Access Management (IAM).
Fournissez une page de connexion à vos clients.
Vous pouvez également :
- Intégrez l'authentification unique (SSO) pour que vos clients puissent se connecter à l'aide de leur compte Google. Si vous intégrez l'authentification unique, lorsque les utilisateurs se connectent à l'aide de l'authentification unique, Google envoie Jeton Web JSON (JWT) contenant des informations sur l'utilisateur à vérifier.
Pour en savoir plus sur l'intégration de l'interface de votre application avec sur Cloud Marketplace, consultez 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.
Intégrer des API Google
Pour intégrer votre application aux API Google, procédez comme suit : à l'aide de bibliothèques clientes, qui vous permettent un accès programmatique aux produits Google. Les bibliothèques clientes sont disponibles les plus populaires, comme 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 créer une bibliothèque cliente, vous devez installer les bibliothèques clientes Google, et créer une bibliothèque à partir du document de découverte des API. à l'adresse suivante :
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Par exemple, si vous créez une bibliothèque cliente Python pour le
l'API Partner Procurement, utilisez le
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.
Activer l'API Partner Procurement dans la console Google Cloud
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.