Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta seção é uma visão geral das etapas para integrar o 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 no seu produto.
Seu engenheiro parceiro cria um tópico Pub/Sub em que você precisa se inscrever para receber notificações.
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 informar as informações de uso.
Para informações detalhadas sobre como integrar o back-end do app ao
Cloud Marketplace, consulte
Configurar o back-end do app.
Para conferir um exemplo de integração do back-end de um produto básico com o
Cloud Marketplace e um tutorial do código de exemplo, consulte o
codelab para integrar um produto 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 criar contas de novos clientes que compram seu
produto pelo Cloud Marketplace. Quando os usuários visitam essa página, o Google
envia um
token da Web JSON (JWT)
que contém o ID da conta do usuário. Use esse ID para vincular a conta do usuário no seu produto à conta do Google e também para o gerenciamento de identidade e acesso (IAM).
Forneça uma página de login para seus clientes.
Também é possível:
Integre o Logon único (SSO) para que os clientes possam fazer login no
aplicativo usando as Contas do Google. Se você integrar o SSO, quando os usuários fizerem login
usando o SSO, o Google vai enviar um
token da web JSON (JWT)
com informações sobre o usuário para você verificar.
Verifique se seu Partner Engineer ativou o acesso à API Partner Procurement do Cloud Commerce. 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 Google Cloud .
Integrar com as APIs do Google
É possível integrar seu app às APIs do Google
usando 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 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 no documento de descoberta da API. O documento de descoberta da API Partner Procurement está neste URL:
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).
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-02 UTC."],[],[],null,["# Integrate your app with Google Cloud Marketplace\n\nThis section is an overview of the steps to integrate your app with\nCloud Marketplace. At a high level, you integrate your app with\nGoogle Cloud in the following ways:\n\n- **Backend integration**\n\n You must integrate your app's backend with the following Google APIs and\n services:\n - Integrate with Pub/Sub to receive notifications from\n Cloud Marketplace, such as when a user signs up for your product.\n Your Partner Engineer creates a Pub/Sub topic that you\n must subscribe to for notifications.\n\n For information on subscribing to a Pub/Sub topic, see\n the [Pub/Sub Subscriber Guide](/pubsub/docs/subscriber).\n - Integrate with the Partner Procurement API to create accounts for\n customers, and to link these accounts with their Cloud Marketplace\n purchase. You must also use the Partner Procurement API to update the\n linked accounts when users change or cancel their subscription plans.\n\n - If you've chosen a usage-based pricing model, integrate with\n Service Control to report usage information.\n\n For detailed information on integrating your app's backend with\n Cloud Marketplace, see\n [Configure your app's backend](/marketplace/docs/partners/integrated-saas/backend-integration).\n\n For an example of integrating the backend of a basic product with\n Cloud Marketplace and a walkthrough of the sample code, see the\n [codelab for integrating a SaaS product](https://codelabs.developers.google.com/codelabs/gcp-marketplace-integrated-saas/#0).\n- **Frontend integration**\n\n In your app's frontend, you must set up the following integrations:\n - Provide a sign up page to sign up accounts for new customers who buy your\n product through Cloud Marketplace. When users visit this page, Google\n sends a\n [JSON Web Token (JWT)](https://jwt.io/introduction/)\n containing the user's account ID. You use this account ID to link the\n user's account in your product with their Google account, and also for\n Identity and Access Management (IAM).\n\n | **Note:** It's possible for a single user to have multiple Google Cloud account IDs, or for multiple users to share a common Google Cloud account ID, depending on how they or their organization have configured their usage of Google Cloud.\n - Provide a login page for your customers.\n\n Optionally, you can choose to:\n - Integrate single sign-on (SSO), so that your customers can sign into your app using their Google accounts. If you integrate SSO, when users sign in by using SSO, Google sends a [JSON Web Token (JWT)](https://jwt.io/introduction/) containing information about the user for you to verify.\n\n For detailed information on integrating your app's frontend with\n Cloud Marketplace, see\n [Integrating your app's frontend](/marketplace/docs/partners/integrated-saas/frontend-integration).\n\nBefore you begin\n----------------\n\n- Verify that your Partner Engineer has enabled access to the Cloud Commerce Partner Procurement API. After your Partner Engineer has granted you access to the Partner Procurement API, you don't need to take any additional steps to enable the API in Google Cloud console.\n\nIntegrate with Google APIs\n--------------------------\n\nYou can integrate your app with Google APIs by\n[using client libraries](/apis/docs/client-libraries-explained), which give you\nprogrammatic access to Google products. The client libraries are available for\nmost popular development platforms, such as Java, Python, and .NET.\n\nInstall the client libraries for your platform from the\n[API Client Libraries page](https://developers.google.com/api-client-library/).\nWith the client libraries, you can:\n\n- Connect to your Pub/Sub subscription, and handle incoming messages.\n- If you chose usage-based pricing, connect to the Service Control API to report usage data to Google.\n\nTo create linked accounts for customers, and to send and receive updates about\nuser accounts, you must also integrate with the Partner Procurement API.\nBecause the Partner Procurement API is restricted, you must build a\nnew client library for the API.\n\nTo build a new client library, you must install the Google client libraries,\nand build a new library from the API discovery document. The discovery document\nfor the Partner Procurement API is at this URL: \n\n https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1\n\nFor example, if you're building a Python client library for the\nPartner Procurement API, use the\n[`build()`](https://googleapis.github.io/google-api-python-client/docs/epy/googleapiclient.discovery-module.html#build)\nmethod. For sample code that builds a client library, see the\n[codelab samples on GitHub](https://github.com/googlecodelabs/gcp-marketplace-integrated-saas/blob/master/python3/impl/step_2_account/app.py#L39)."]]
