Esta página foi traduzida pela API Cloud Translation.
Switch to English

Como integrar seu aplicativo: configuração

Nesta seção, apresentamos a você uma visão geral das etapas para integrar o aplicativo ao Google 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:

    • Integre-se ao Pub/Sub para receber notificações do Google 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.

    • Integre-se à API Partner Procurement para criar contas para clientes e vincular essas contas à compra do Google 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 Google Cloud Marketplace, consulte Como integrar o back-end do aplicativo.

    Para um exemplo de integração do back-end de um produto básico com o Google Cloud Marketplace e um tutorial do código de exemplo, consulte o codelab para integrar um produto SaaS.

  • Integração do front-end

    É preciso configurar as seguintes integrações no front-end do app:

    • Crie uma página de ativação para novos clientes que comprarem seu produto por meio do Google Cloud Marketplace. Quando novos clientes são direcionados para esta página, o Google também envia um JSON Web Token (JWT), que contém o ID da conta do usuário. É possível usar esse ID da conta para criar uma nova conta para o usuário e vinculá-la à conta do Google.

    • Integrar o Logon único (SSO) para que os usuários possam fazer login no aplicativo usando as Contas do Google. Para integrar o SSO, o aplicativo precisa verificar um JWT em que esteja o ID da conta do usuário. Seu aplicativo precisa comparar o ID da conta com a conta vinculada do usuário.

    Para informações detalhadas sobre como integrar o front-end do aplicativo ao Google Cloud Marketplace, consulte Como integrar o front-end do aplicativo.

Antes de começar

  • Verifique se seu Partner Engineer ativou o acesso à API Partner Procurement do Cloud Commerce.

Integrar às 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 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).

Como ativar a API Partner Procurement no Console do Cloud

Portal do Produtor

Se você estiver usando o Portal do Produtor, depois que o Engenheiro de parceiros conceder a você o acesso à API Partner Procurement, não será necessário realizar outras etapas para ativar a API no Console do Cloud.

Portal do parceiro

Se você estiver usando o Portal do parceiro, depois que o Engenheiro de parceiros conceder a você o acesso à API Partner Procurement, acesse o seguinte URL para ativá-la no Console do Cloud:

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

em que YOUR_PROJECT_ID é o projeto que hospeda a solução que você criou ao configurar seu ambiente.