En esta sección se resumen los pasos para integrar tu aplicación con Cloud Marketplace. A grandes rasgos, puedes integrar tu aplicación con Google Cloud de las siguientes formas:
Integración del backend
Debes integrar el backend de tu aplicación con las siguientes APIs y servicios de Google:
Integrar Pub/Sub para recibir notificaciones de Cloud Marketplace, como cuando un usuario se registra en tu producto. Tu ingeniero de partners crea un tema de Pub/Sub al que debes suscribirte para recibir notificaciones.
Para obtener información sobre cómo suscribirse a un tema de Pub/Sub, consulta la guía de suscriptor de Pub/Sub.
Integra la API Partner Procurement para crear cuentas para los clientes y vincularlas con su compra de Cloud Marketplace. También debes usar la API Partner Procurement para actualizar las cuentas vinculadas cuando los usuarios cambien o cancelen sus planes de suscripción.
Si has elegido un modelo de precios basado en el uso, integra la API Service Control para enviar información sobre el uso.
Para obtener información detallada sobre cómo integrar el backend de tu aplicación con Cloud Marketplace, consulta Configurar el backend de tu aplicación.
Para ver un ejemplo de cómo integrar el backend de un producto básico con Cloud Marketplace y una guía del código de muestra, consulta el codelab para integrar un producto de SaaS.
Integración de frontend
En el frontend de tu aplicación, debes configurar las siguientes integraciones:
Proporciona una página de registro para que los nuevos clientes que compren tu producto a través de Cloud Marketplace puedan crear una cuenta. Cuando los usuarios visitan esta página, Google envía un JSON Web Token (JWT) que contiene el ID de la cuenta del usuario. Este ID de cuenta se usa para vincular la cuenta del usuario en tu producto con su cuenta de Google, así como para la gestión de identidades y accesos (IAM).
Proporciona una página de inicio de sesión a tus clientes.
También puedes hacer lo siguiente:
- Integra el inicio de sesión único (SSO) para que tus clientes puedan iniciar sesión en tu aplicación con sus cuentas de Google. Si integras el SSO, cuando los usuarios inicien sesión mediante el SSO, Google enviará un JSON Web Token (JWT) que contenga información sobre el usuario para que puedas verificarla.
Para obtener información detallada sobre cómo integrar el frontend de tu aplicación con Cloud Marketplace, consulta Integrar el frontend de tu aplicación.
Antes de empezar
- Verifica que tu ingeniero de partners haya habilitado el acceso a la API Partner Procurement de Cloud Commerce. Una vez que tu ingeniero de partners te haya concedido acceso a la API Partner Procurement, no tendrás que hacer nada más para habilitarla en la consola. Google Cloud
Integración con las APIs de Google
Puedes integrar tu aplicación con las APIs de Google mediante bibliotecas de cliente, que te permiten acceder a los productos de Google de forma programática. Las bibliotecas de cliente están disponibles para las plataformas de desarrollo más populares, como Java, Python y .NET.
Instala las bibliotecas de cliente de tu plataforma desde la página de bibliotecas de cliente de las APIs. Con las bibliotecas de cliente, puedes hacer lo siguiente:
- Conéctate a tu suscripción de Pub/Sub y gestiona los mensajes entrantes.
- Si has elegido la opción de precios basados en el uso, conéctate a la API Service Control para enviar datos de uso a Google.
Para crear cuentas vinculadas para los clientes, así como para enviar y recibir actualizaciones sobre las cuentas de usuario, también debe integrar la API Partner Procurement. Como la API Partner Procurement está restringida, debes crear una biblioteca de cliente para la API.
Para crear una biblioteca de cliente, debes instalar las bibliotecas de cliente de Google y crear una biblioteca a partir del documento de descubrimiento de la API. El documento de descubrimiento de la API Partner Procurement se encuentra en esta URL:
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Por ejemplo, si estás creando una biblioteca de cliente de Python para la API Partner Procurement, usa el método build(). Para ver un ejemplo de código que crea una biblioteca de cliente, consulta los ejemplos de codelab en GitHub.