Para oferecer um produto de agente de IA através do Google Cloud Marketplace, tem de integrar o seu produto com o Google Cloud. Esta integração técnica envolve vários passos no back-end e no front-end do seu produto.
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
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 engenheiro parceiro cria um tópico do Pub/Sub ao qual tem de se inscrever para receber notificações.
Para obter informações sobre como subscrever um tópico Pub/Sub, consulte o guia do subscritor do Pub/Sub.
Faça a integração com a API Partner Procurement. Isto permite-lhe fazer o seguinte:
- Crie contas para clientes.
- Associe as contas dos clientes à respetiva compra no Cloud Marketplace.
- 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 um passo a passo do código de exemplo, consulte o codelab para integrar um produto de software como serviço (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. Use 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) que contém 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 Integre o frontend da sua app.
Faça a integração com as APIs Google
Pode integrar o seu produto de agente de IA 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 API Partner Procurement. 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 para a 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.
O que se segue?
- Configure o back-end da sua app.
- Integre o frontend da sua app.
- Publique o seu agente de IA no Cloud Marketplace.