Intégrer votre application : configuration

Cette section décrit les étapes à suivre pour intégrer votre application à Google 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 :

    • L'intégration à Pub/Sub permet de recevoir des notifications de Google 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 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 en savoir plus sur l'intégration du backend de votre application à Google Cloud Marketplace, consultez la section 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 un produit 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 produit 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'ID de compte de l'utilisateur. Vous pouvez utiliser cet ID de compte afin de 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 en savoir plus sur l'intégration de l'interface de votre application à Google 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.

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 :

  • 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 vos clients, et pour envoyer et recevoir des informations 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 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 la console

Producer Portal

Si vous utilisez Producer Portal, vous n'avez rien à faire pour l'activer dans la 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, après que votre ingénieur partenaire vous a accordé l'accès à l'API Partner Procurement, accédez à l'URL suivante pour activer l'API dans la 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.