Esta seção é uma visão geral das etapas para integrar seu app ao Cloud Marketplace. Em um nível alto, você integra seu app com Google Cloud das seguintes maneiras:
Integração do back-end
Você precisa fazer a integração do back-end do app às APIs e aos seguintes serviços do Google:
Integre-se ao Pub/Sub para receber notificações do Cloud Marketplace, como quando um usuário se inscreve na solução. Seu Engenheiro de parceiros cria um tópico Pub/Sub em que você precisa se inscrever para receber notificações.
Para informações sobre como assinar um tópico do Pub/Sub, consulte o Guia de assinantes de Pub/Sub.
Integre-se à API Partner Procurement para criar contas para clientes e vincular essas contas à compra do Cloud Marketplace. Você também precisa usar a API Partner Procurement para atualizar as contas vinculadas quando os usuários alterarem ou cancelarem os planos de assinatura deles.
Se você escolheu um modelo de preços com base no uso, integre-o ao Service Control para relatar as informações de uso.
Para informações detalhadas sobre como integrar o back-end do aplicativo ao Cloud Marketplace, consulte Configurar o back-end do app.
Para ver um exemplo de integração do back-end de um produto básico ao Cloud Marketplace e um tutorial do código de amostra, consulte o codelab para integrar uma solução de SaaS.
Integração do front-end
É preciso configurar as seguintes integrações no front-end do app:
Forneça uma página de inscrição para novos clientes que comprarem seu produto pelo Cloud Marketplace. Quando os usuários acessam essa página, o Google envia um JSON Web Token (JWT) que contém o ID da conta do usuário. Use esse ID de conta para vincular a conta do usuário no seu produto à Conta do Google dele e também para o Identity and Access Management (IAM).
Forneça uma página de login para seus clientes.
Opcionalmente, você pode:
- Integrar o Logon único (SSO) para que os clientes possam fazer login no app usando as Contas do Google. Se você integrar o SSO, quando os usuários fizerem login usando o SSO, o Google enviará um JSON Web Token (JWT) contendo informações sobre o usuário para você verificar.
Para informações detalhadas sobre como integrar o front-end do aplicativo ao Cloud Marketplace, consulte Como integrar o front-end do aplicativo.
Se você usa o App Lifecycle Manager para implantar e operar seu produto SaaS, também pode aproveitar a validação simplificada e a integração de locatários com um clique. Para mais informações, consulte Integrar com o App Lifecycle Manager.
Antes de começar
- Verifique se seu Engenheiro de parceiros ativou o acesso à API Cloud Commerce Partner Procurement. Depois que o Engenheiro de parceiros conceder a você o acesso a API Partner Procurement, não será necessário realizar outras etapas para ativar a API no Google Cloud console.
Integrar com as APIs do Google
É possível integrar o aplicativo às APIs do Google usando bibliotecas de clientes que ofereçam acesso programático aos produtos do Google. As bibliotecas de cliente estão disponíveis para as plataformas de desenvolvimento mais usadas, como Java, Python e .NET.
Instale as bibliotecas de cliente para sua plataforma na página Bibliotecas de cliente da API. Com as bibliotecas de cliente, é possível:
- Conecte-se à sua assinatura do Pub/Sub e processe as mensagens recebidas.
- se você escolher o preço com base no uso, conectar-se à API Service Control para relatar os dados de uso ao Google.
Para criar contas vinculadas para clientes e enviar e receber atualizações sobre contas de usuários, você também precisa se integrar à API Partner Procurement. Como a API Partner Procurement é restrita, é preciso criar uma nova biblioteca de cliente para a API.
Para criar uma nova biblioteca de cliente, instale as bibliotecas de cliente do Google e crie uma nova biblioteca a partir do documento de descoberta da API. O documento de descoberta da API Partner Procurement está neste URL:
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Por exemplo, se você estiver criando uma biblioteca de cliente do Python para a
API Partner Procurement, use o
build()
método. Para ver o exemplo de código de criação de uma biblioteca de cliente, consulte as
amostras de codelab no GitHub.