Lembrete: a partir de 2 de agosto de 2023, todos os novos apps precisarão usar a versão 5 ou mais recente da Biblioteca Faturamento. A partir de 1º de novembro de 2023, isso também será válido para todas as atualizações dos apps atuais. Saiba mais.

Sistema de faturamento do Google Play

O sistema de faturamento do Google Play é um serviço que permite vender produtos e conteúdos digitais no seu app Android, seja para gerar receita com compras únicas ou oferecer assinaturas aos seus serviços. O Google Play oferece um conjunto completo de APIs para integração com seu app Android e o back-end do servidor, desbloqueando a familiaridade e segurança das compras do Google Play para os usuários.

Arquitetura de integração

Esta seção apresenta os diferentes módulos funcionais que podem ser criados e as APIs e bibliotecas disponíveis para simplificar o processo.

Seu app Android funciona com o back-end do desenvolvedor e o back-end do Google Play (pelo Google Play Services).
Figura 1. Diagrama de uma integração típica do Google Play Faturamento.

Integre o sistema de faturamento do Google Play ao seu app Android usando a Biblioteca Play Faturamento. Essa biblioteca permite a comunicação com a camada do Google Play Services que fornece a oferta de produto localizada disponível para cada usuário no seu app. Ela também oferece métodos para processar outras operações do usuário necessárias, como iniciar o fluxo de compra e processar os resultados.

Você também precisa integrar o sistema de faturamento do Google Play ao back-end do servidor para criar os fluxos de desenvolvimento necessários. Isso é essencial para garantir que o gerenciamento de compras e os direitos multiplataforma sejam eficazes e seguros. Crie essa integração usando a API Subscriptions and In-App Purchases, fornecida pela API Google Play Developer. A integração de back-end também aproveita algumas ferramentas do Google Cloud Platform.

Figura 2. APIs e serviços fornecidos pela API Google Play Developer.

Terminologia

Esta seção lista e descreve as tecnologias e os conceitos de alto nível que você pode encontrar ao integrar o sistema de faturamento do Google Play com seu app. Consulte a lista conforme avança na orientação de integração.

Tecnologias

  • Google Play: uma loja on-line em que os usuários podem fazer o download de apps e outros produtos digitais.
  • Google Play Console: uma plataforma que oferece uma interface para você publicar seu app no Google Play. O Google Play Console também mostra detalhes sobre seu app, incluindo todos os produtos ou conteúdos que você vende com o Google Play.
  • Console do Google Cloud: uma plataforma que gerencia APIs de back-end, como a API Google Play Developer.
  • Biblioteca Google Play Faturamento: uma API que pode ser usada para integrar o sistema de faturamento do Google Play a um app.
  • API Google Play Developer: uma API REST que pode ser usada para processar tarefas de publicação e gerenciamento de apps de maneira programática.
  • Cloud Pub/Sub: um serviço de mensagens em tempo real totalmente gerenciado que permite enviar e receber mensagens entre aplicativos independentes. O Google Play usa o Cloud Pub/Sub para entregar notificações do desenvolvedor em tempo real. Para usar o Cloud Pub/Sub, é preciso ter um projeto no Google Cloud Platform (GCP) com a API Cloud Pub/Sub ativada. Se você não conhece o GCP e o Cloud Pub/Sub, consulte o Guia de início rápido.
  • Notificações do desenvolvedor em tempo real: um mecanismo que permite monitorar mudanças de estado para assinaturas gerenciadas pelo Google Play em tempo real, aproveitando o Cloud Pub/Sub.
  • Servidor de back-end seguro: como parte da integração do sistema de faturamento do Google Play no seu app, recomendamos usar um servidor de back-end seguro para implementar tarefas relacionadas ao faturamento, como verificação de compras, recursos específicos para assinaturas e o processamento de notificações do desenvolvedor em tempo real.
  • App Google Play Store: um app que gerencia todas as operações relacionadas ao Google Play. Todas as solicitações feitas pelo seu app são processadas pelo app Google Play Store.

Conceitos

  • Fluxo: um fluxo mostra etapas típicas de uma tarefa de faturamento. Por exemplo, um fluxo de compra descreve as etapas de quando um usuário compra seu produto. Um fluxo de assinatura pode mostrar como uma assinatura faz a transição entre estados.
  • Direito de acesso: quando um usuário faz uma compra no app, ele tem direito de acesso ao produto comprado. Para produtos únicos, isso significa que o usuário terá acesso permanente a eles. Para assinaturas, isso significa que o usuário terá acesso enquanto a assinatura estiver ativa.
  • ID do produto: o ID de um tipo de produto específico.
  • Token da compra: uma string que representa o direito de acesso de um comprador a um produto no Google Play. O token indica que um usuário do Google pagou por um produto específico.
  • Código do pedido: uma string que representa uma transação financeira no Google Play. Um código do pedido é criado sempre que ocorre uma transação financeira. Essa string é incluída em um recibo enviado por e-mail ao comprador. É possível usar o código do pedido para gerenciar reembolsos na seção Gerenciamento de pedidos do Google Play Console. Os códigos de pedidos também são usados em relatórios de vendas e de pagamentos.

Entrar em contato

Queremos saber sua opinião Avalie nosso desempenho de uma das seguintes maneiras:

  • Para problemas relacionados à Biblioteca Google Play Faturamento ou à API Google Developer, informe um bug pelo Issue Tracker do Google.
  • Para questões relacionadas aos apps de exemplo, informe um problema no Issue Tracker do GitHub (em inglês).

Próximas etapas

Para começar a integrar o sistema de faturamento do Google Play ao back-end do app e do servidor, consulte o guia de configuração.