Intégrer votre application : configuration

Cette section présente les étapes à suivre pour intégrer votre application à Google Cloud Marketplace. En règle générale, vous intégrez votre application à Google Cloud de différentes manières :

  • 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 Google Cloud Marketplace, par exemple lorsqu'un utilisateur s'inscrit à votre solution. 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 Google 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 plus d'informations sur l'intégration du backend de votre application à Google 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 à Google Cloud Marketplace et un tutoriel pour l'exemple de code, consultez l'atelier de programmation pour intégrer une solution SaaS.

  • Intégration de l'interface

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

    • Créez une page d'activation pour les nouveaux clients qui achètent votre solution via Google Cloud Marketplace. Lorsque de nouveaux clients sont dirigés vers cette page, Google envoie également un jeton Web JSON (JWT), qui contient l'identifiant de compte de l'utilisateur. Vous pouvez utiliser cet identifiant de compte pour créer un compte pour l'utilisateur et l'associer à son compte Google.

    • Intégrez l'authentification unique (SSO) afin que les utilisateurs puissent se connecter à votre application à l'aide de leur compte Google. Pour intégrer SSO, votre application doit valider un jeton JWT contenant l'identifiant de compte de l'utilisateur. Votre application doit vérifier l'identifiant de compte avec le compte associé de l'utilisateur.

    Pour plus d'informations sur l'intégration de l'interface de votre application à Google 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 une application aux 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 :

  • Connectez-vous à votre abonnement Pub/Sub et gérez 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.

Activer l'API Partner Procurement dans Cloud Console

Producer Portal

Si vous utilisez le Producer Portal, vous n'avez pas besoin de suivre d'autres étapes pour activer l'API dans Cloud Console une fois que votre ingénieur partenaire vous a accordé l'accès à l'API Partner Procurement,.

Portail des partenaires

Si vous utilisez le portail des partenaires, accédez à l'URL suivante une fois que votre ingénieur partenaire vous a accordé l'accès à l'API Partner Procurement pour activer l'API dans Cloud Console :

https://console.cloud.google.com/apis/api/cloudcommerceprocurement.googleapis.com/overview?project=YOUR_PROJECT_ID

YOUR_PROJECT_ID est le projet qui héberge votre solution et que vous avez créé lors de la configuration de l'environnement.