Integrar tu app: configuración

Esta sección es una descripción general de los pasos para integrar tu app en Cloud Marketplace. En un nivel alto, debes integrar tu app en Google Cloud de las siguientes maneras:

  • Integración de backend

    Debes integrar el backend de la app en las API de Google y los servicios siguientes:

    • Integra a Pub/Sub para recibir notificaciones de Cloud Marketplace, como cuando un usuario se registra en tu producto. Tu Ingeniero socio crea un tema Pub/Sub al que te debes suscribir para las notificaciones.

      Para obtener información sobre cómo suscribirse a un tema de Pub/Sub, consulta la Guía sobre suscriptores de Pub/Sub.

    • Integra en la API de Partner Procurement a fin de crear cuentas para clientes y vincularlas a su compra de Cloud Marketplace. También debes usar la API de Partner Procurement para actualizar las cuentas vinculadas cuando los usuarios cambien o cancelen sus planes de suscripción.

    • Si elegiste un modelo de precios basados en el uso, intégralo en el Control de servicios para informar la información de uso.

    Para obtener información detallada sobre cómo integrar el backend de la app en Cloud Marketplace, consulta Integra el backend de la app.

    Para ver un ejemplo de integración del backend de un producto básico en Cloud Marketplace y una explicación del código de muestra, consulta el codelab para integrar un producto de SaaS.

  • Integración de frontend

    En el frontend de la app, debes configurar las siguientes integraciones:

    • Proporciona una página de registro para registrar cuentas de clientes nuevos que compren tu producto a través de Cloud Marketplace. Cuando los usuarios visitan esta página, Google envía un Token web JSON (JWT) con el ID de la cuenta del usuario. Usa este ID de cuenta para vincular la cuenta del usuario en tu producto con su Cuenta de Google, y también para Identity and Access Management (IAM).

    • Proporciona una página de acceso para tus clientes.

    De forma opcional, tienes las siguientes opciones:

    • Integra el inicio de sesión único (SSO), para que tus clientes puedan acceder a tu app con sus Cuentas de Google. Si integras el SSO, cuando los usuarios acceden mediante este servicio, Google envía un Token web JSON (JWT) con información sobre el usuario para que lo verifiques.

    Para obtener información detallada sobre la integración del frontend de la app en Cloud Marketplace, consulta Integra el frontend de la app.

Antes de comenzar

  • Verifica que el Ingeniero socio habilite el acceso a la API de Partner Procurement de Cloud Commerce.

Integración con las APIs de Google

Puedes integrar tu app en las APIs de Google mediante bibliotecas cliente, que te brindan acceso programático a los productos de Google. Las bibliotecas cliente están disponibles para las plataformas de desarrollo más populares, como Java, Python y .NET.

Instala las bibliotecas cliente para la plataforma desde la página de la API de Bibliotecas cliente.

Con las bibliotecas cliente, puedes realizar lo siguiente:

  • Conéctate a tu suscripción de Pub/Sub y administra los mensajes entrantes.

  • Si elegiste un precio basado en el uso, conectarte a la API de control de servicios para informar los datos del uso a Google

A fin de crear cuentas vinculadas para los clientes y enviar y recibir actualizaciones sobre las cuentas de usuario, también debes realizar la integración en la API de Partner Procurement. Debido a que la API de Partner Procurement está restringida, debes compilar una biblioteca cliente nueva para la API.

Para compilar una biblioteca cliente nueva, debes instalar las bibliotecas cliente de Google y compilar una biblioteca cliente nueva desde el documento de descubrimiento de la API. El documento de descubrimiento para la API de Partner Procurement se encuentra en esta URL:

https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1

Por ejemplo, si compilas una biblioteca cliente de Python para la API de Partner Procurement, usa el método build(). Para ver el código de muestra que compila una biblioteca cliente, consulta las muestras de codelab en GitHub.

Habilita la API de Partner Procurement en la consola de Google Cloud

Después de que tu Ingeniero socio te haya otorgado acceso a la API de Partner Procurement, no necesitas realizar ningún paso adicional para habilitar la API en la consola de Google Cloud.