Integra tu aplicación: configuración

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

  • Integración de backend

    Debes integrar el backend de la aplicación en las API y los servicios de Google siguientes:

    • Integra en Pub/Sub para recibir notificaciones de Google Cloud Marketplace, como cuando un usuario se registra para la solución. Tu Ingeniero socio crea un tema Pub/Sub al que te debes suscribir para recibir las notificaciones.

      Para obtener información sobre un tema de Pub/Sub, consulta la Guía de suscripción de Pub/Sub.

    • Integra con la API de Partner Procurement para crear cuentas para los clientes y vincular estas cuentas con sus compras de Google 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 ya elegiste un modelo de precios basados en el uso, intégralo en Control de servicios para informar la información de uso.

    Para obtener información detallada sobre la integración del backend de la aplicación en Google Cloud Marketplace, consulta Integración de backend.

    Si deseas ver un ejemplo de integración del backend de un producto básico con Google Cloud Marketplace y un instructivo del código de muestra, consulta el codelab para integrar un servicio administrado.

  • Integración de frontend

    En el frontend de la aplicación, debes configurar las siguientes integraciones:

    • Crea una página de activación para los clientes nuevos que compran la solución a través de Google Cloud Marketplace. Cuando se dirige a clientes nuevos a esta página, Google también envía un token web JSON (JWT), que contiene el ID de la cuenta del usuario. Puedes usar este ID de la cuenta a fin de crear una cuenta nueva para el usuario y vincularla a su cuenta de Google.

    • Integra un inicio de sesión único (SSO), para que los usuarios puedan acceder a la aplicación mediante sus Cuentas de Google. Para integrar el SSO, tu aplicación debe verificar un JWT que contenga el ID de la cuenta del usuario. Tu aplicación debe verificar el ID de cuenta con la cuenta vinculada del usuario.

    Para obtener información detallada sobre la integración del frontend de la aplicación en Google Cloud Marketplace, consulta Integración de frontend.

Antes de comenzar

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

Integra las API de Google

Puedes integrar la aplicación en las API de Google mediante las bibliotecas cliente, que te otorgan acceso programático a los productos de Google. Las bibliotecas cliente están disponibles para la mayoría de las plataformas de desarrollo, 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 a 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

Para crear cuentas vinculadas a los clientes, y enviar y recibir actualizaciones sobre las cuentas de usuario, debes integrarte 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, tienes que 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 un código de muestra que compila una biblioteca cliente, consulta las muestras de codelab en GitHub.

Habilita la API en Cloud Console

Después de que el Ingeniero socio habilite el acceso a la API de Partner Procurement, habilita la API en Cloud Console en la siguiente URL:

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

En este ejemplo, YOUR_PROJECT_ID es el proyecto que aloja tu solución, que creaste cuando configuraste tu entorno.