Pour proposer un produit d'agent d'IA sur Google Cloud Marketplace, vous devez intégrer votre produit à Google Cloud. Cette intégration technique implique plusieurs étapes dans le backend et le frontend de votre produit.
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é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. Vous pouvez ainsi effectuer les opérations suivantes :
- créer des comptes pour les clients ;
- Associez les comptes des clients à leurs achats Cloud Marketplace.
- Mettez à jour les comptes associés lorsque les utilisateurs modifient ou annulent leurs forfaits.
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 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 Software as a Service (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, ainsi que 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 Intégrer l'interface de votre application.
Intégrer des API Google
Vous pouvez intégrer votre produit d'agent d'IA aux API Google en utilisant des 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.
Étapes suivantes
- Configurez le backend de votre application.
- Intégrez l'interface de votre application.
- Publiez votre agent d'IA sur Cloud Marketplace.