Esta seção é uma visão geral das etapas para integrar seu app ao Cloud Marketplace. Em alto nível, é possível integrar o app ao 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:
Faça a integração com o Pub/Sub para receber notificações do Cloud Marketplace, como quando um usuário se inscreve no seu produto. Seu engenheiro parceiro 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.
Faça a integração com a API Partner Procurement para criar contas para clientes e vinculá-las à 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 gerar relatórios com informações de uso.
Para informações detalhadas sobre como integrar o back-end do app ao Cloud Marketplace, consulte Como integrar o back-end do app.
Para ver um exemplo de integração do back-end de um produto básico com o Cloud Marketplace e um tutorial do exemplo de código, consulte o codelab para integrar um produto 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 registrar contas de novos clientes que compram seu produto pelo Cloud Marketplace. Quando os usuários acessam essa página, o Google envia um Token da Web JSON (JWT, na sigla em inglês) contendo o ID da conta do usuário. Use esse ID da conta para vincular a conta do usuário no seu produto à Conta do Google e também ao Identity and Access Management (IAM).
Disponibilize uma página de login para seus clientes.
Como opção, você pode:
- Integre o Logon único (SSO) para que os clientes façam login no app usando as Contas do Google deles. Se você integrar o SSO, quando os usuários fizerem login usando esse recurso, o Google enviará um Token da Web JSON (JWT, na sigla em inglês) com informações sobre os usuários para verificação.
Para informações detalhadas sobre como integrar o front-end do seu app ao Cloud Marketplace, consulte Como integrar o front-end do seu app.
Antes de começar
- Verifique se seu Partner Engineer ativou o acesso à API Partner Procurement do Cloud Commerce.
Integrar com APIs do Google
Para integrar seu app com as APIs do Google, use bibliotecas de cliente, que oferecem acesso programático aos produtos do Google. As bibliotecas de cliente estão disponíveis para as plataformas de desenvolvimento mais conhecidas, 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ário, você também precisa fazer a integração com a API Partner Procurement. Como a API Partner Procurement é restrita, é necessário criar uma nova biblioteca de cliente para a API.
Para criar uma nova biblioteca de cliente, instale as bibliotecas do Google e crie uma nova com o 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
método
build(). Para ver o código de amostra de criação de uma biblioteca
de cliente, consulte as amostras de codelab no GitHub (em inglês).
Ativar a API Partner Procurement no console do Google Cloud
Depois que o Engenheiro de parceiros conceder a você acesso à API Partner Procurement, não será necessário realizar outras etapas para ativar a API no Console do Google Cloud.