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 :
Effectuez l'intégration à 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 les clients et de les associer à 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 à 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 page Intégrer le backend de votre application.
Pour obtenir un exemple d'intégration du backend d'un produit de base avec Cloud Marketplace et un tutoriel de l'exemple de code, consultez l'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 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. Cet ID de compte vous permet d'associer le compte de l'utilisateur dans votre produit à son compte Google, ainsi que pour Identity and Access Management (IAM).
Fournissez une page de connexion à vos clients.
Vous pouvez également effectuer les actions suivantes:
- Intégrez l'authentification unique (SSO) afin que vos clients puissent se connecter à votre application à l'aide de leurs comptes Google. Si vous intégrez l'authentification unique, lorsque les utilisateurs se connectent à l'aide de l'authentification unique, Google envoie un 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 à Cloud Marketplace, consultez la page 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 les API Google
Vous pouvez intégrer votre application aux API Google à l'aide de bibliothèques clientes, qui vous donnent un accès programmatique aux produits Google. Les bibliothèques clientes 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 associé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'API Partner Procurement étant limitée, vous devez créer une bibliothèque cliente pour l'API.
Pour compiler une bibliothèque cliente, vous devez installer les bibliothèques clientes Google, puis en créer une à partir du document de découverte de l'API. à 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.
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, aucune action supplémentaire n'est requise pour l'activer dans la console Google Cloud.