Esta secção é uma vista geral dos passos para integrar a sua app com o Cloud Marketplace. A um nível elevado, integra a sua app com o Google Cloud das seguintes formas:
Integração de back-end
Tem de integrar o back-end da sua app com os seguintes serviços e APIs Google:
Integre-se com o Pub/Sub para receber notificações do Cloud Marketplace, como quando um utilizador se inscreve no seu produto. O seu engenheiro de parceiros cria um tópico do Pub/Sub ao qual tem de subscrever para receber notificações.
Para obter informações sobre como subscrever um tópico Pub/Sub, consulte o guia do subscritor do Pub/Sub.
Integre-se com a API Partner Procurement para criar contas para clientes e associar estas contas à respetiva compra no Cloud Marketplace. Também tem de usar a API Partner Procurement para atualizar as contas associadas quando os utilizadores alteram ou cancelam os respetivos planos de subscrição.
Se escolheu um modelo de preços baseado na utilização, faça a integração com o Service Control para comunicar informações de utilização.
Para informações detalhadas sobre a integração do back-end da sua app com o Cloud Marketplace, consulte o artigo Configure o back-end da sua app.
Para ver um exemplo de integração do back-end de um produto básico com o Cloud Marketplace e uma explicação passo a passo do código de exemplo, consulte o codelab para integrar um produto SaaS.
Integração de front-end
No front-end da sua app, tem de configurar as seguintes integrações:
Disponibilize uma página de inscrição para inscrever contas de novos clientes que comprem o seu produto através do Cloud Marketplace. Quando os utilizadores visitam esta página, a Google envia um símbolo da Web JSON (JWT) que contém o ID da conta do utilizador. Usa este ID da conta para associar a conta do utilizador no seu produto à respetiva Conta Google, bem como para a gestão de identidades e acessos (IAM).
Disponibilize uma página de início de sessão para os seus clientes.
Opcionalmente, pode optar por:
- Integre o início de sessão único (SSO) para que os seus clientes possam iniciar sessão na sua app através das respetivas Contas Google. Se integrar o SSO, quando os utilizadores iniciam sessão através do SSO, a Google envia um símbolo da Web JSON (JWT) com informações sobre o utilizador para validação.
Para informações detalhadas sobre a integração do frontend da sua app com o Cloud Marketplace, consulte o artigo Integrar o frontend da sua app.
Antes de começar
- Confirme se o seu engenheiro de parceiros ativou o acesso à API Cloud Commerce Partner Procurement. Depois de o engenheiro de parceiros lhe conceder acesso à API Partner Procurement, não tem de realizar mais passos para ativar a API na consola. Google Cloud
Faça a integração com as APIs Google
Pode integrar a sua app com as APIs Google através de bibliotecas cliente, que lhe dão acesso programático aos produtos Google. As bibliotecas cliente estão disponíveis para as plataformas de desenvolvimento mais populares, como Java, Python e .NET.
Instale as bibliotecas cliente para a sua plataforma a partir da página de bibliotecas cliente da API. Com as bibliotecas de cliente, pode:
- Estabeleça ligação à sua subscrição do Pub/Sub e processe mensagens recebidas.
- Se escolheu os preços baseados na utilização, estabeleça ligação à API Service Control para comunicar os dados de utilização à Google.
Para criar contas associadas para clientes e enviar e receber atualizações sobre contas de utilizador, também tem de fazer a integração com a Partner Procurement API. Uma vez que a API Partner Procurement é restrita, tem de criar uma nova biblioteca cliente para a API.
Para criar uma nova biblioteca cliente, tem de instalar as bibliotecas cliente Google e criar uma nova biblioteca a partir do documento de descoberta da API. O documento de deteção da Partner Procurement API está neste URL:
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Por exemplo, se estiver a criar uma biblioteca cliente Python para a API Partner Procurement, use o método build(). Para ver um exemplo de código que cria uma biblioteca cliente, consulte os
exemplos do codelab no GitHub.