Visão geral
O Google Play Console oferece um conjunto de APIs de serviço da Web baseadas em REST que permitem executar publicações, relatórios e outras funções de gerenciamento de apps diretamente no seu app.
Nem todos os desenvolvedores precisam usar essas APIs. Na maioria dos casos, você pode continuar gerenciando seus apps diretamente com o Google Play Console. No entanto, se você tiver um grande número de APKs para gerenciar ou tiver que rastrear compras e assinaturas de usuários, essas APIs podem ser úteis.
O que está incluído
As APIs Google Play Developer permitem que você se concentre em projetar e desenvolver seu app, gastando menos tempo e esforço no gerenciamento das versões, mesmo enquanto cresce em novos mercados.
O Google Play Console inclui um pacote de APIs que você pode usar para gerenciar seu app:
- A API Publishing permite fazer upload e publicar apps, além de realizar outras tarefas relacionadas à publicação.
- A API Subscriptions and In-App Purchases permite gerenciar compras e assinaturas no aplicativo. Antes ela era conhecida como "API Purchase Status".
- A API Reporting permite recuperar informações sobre a qualidade do app no Android vitals.
- A API Reply to Reviews permite recuperar e responder a avaliações do seu app.
- A API Permissions permite automatizar o gerenciamento de permissões no Play Console.
- A API Play Games Services Management permite que você emita chamadas REST para controlar programaticamente os metadados dos recursos dos serviços relacionados a recursos de serviços relacionados a jogos do Google Play.
- A API Voided Purchases oferece uma lista de pedidos associados a compras anuladas por um usuário.
Começar
Para começar a usar as APIs Google Play Developer, consulte a documentação Como começar.
API Publishing
A API Publishing permite automatizar tarefas comuns relacionadas à distribuição de apps. Ela fornece funções semelhantes àquelas disponibilizadas a um desenvolvedor por meio do Play Console, como:
- carregar novas versões de um app;
- Liberar apps, atribuindo APKs a várias faixas (alfa, beta, lançamento gradual ou produção).
- Criar e modificar páginas da Google Play Store, incluindo texto e gráficos localizados e capturas de tela para vários dispositivos.
Essas tarefas são executadas usando o recurso de edições, que emprega uma abordagem transacional para fazer mudanças. Isso permite que você agrupe várias alterações em uma única edição de rascunho e, em seguida, confirme as alterações de uma só vez. Nenhuma mudança tem efeito até que a edição seja confirmada.
Práticas recomendadas
- Limite o número de atualizações do app. Não publique atualizações Alfa ou Beta com mais frequência do que uma vez por dia. Os apps de produção precisam ser atualizados com menos frequência do que isso. Toda atualização custa tempo e, talvez, dinheiro aos seus usuários. Se você atualizar com muita frequência, os usuários começarão a ignorar as atualizações ou até mesmo desinstalar o produto.
API Subscriptions and In-App Purchases
A API Subscriptions and In-App Purchases
permite gerenciar o catálogo de
produtos e assinaturas do app. Além disso, com a
API Subscriptions and In-App Purchases, é possível consultar rapidamente os detalhes de
qualquer compra usando uma solicitação GET padrão.
Na solicitação, forneça informações sobre a compra: nome do pacote do app, código da compra ou assinatura e o token de compra. O servidor responde com um objeto JSON descrevendo os detalhes da compra, o status do pedido, o payload do desenvolvedor e outras informações associadas.
Você pode usar essa API de várias maneiras, como para gerar relatórios e reconciliar pedidos individuais e verificar compras e expirações de assinaturas. Você também pode usar a API para saber mais sobre pedidos cancelados e confirmar se os produtos no aplicativo foram consumidos, inclusive se foram consumidos antes de serem cancelados.
Práticas recomendadas
- Armazene informações de assinatura no seu servidor para evitar chamadas de API desnecessárias. Quando o app precisa verificar uma assinatura, use as informações armazenadas em cache no servidor em vez de repetir a chamada de API para o Google.
- Há dois cenários em que o servidor seguro precisa usar a API Google Play
Developer para receber informações de assinatura:
- Seu servidor recebe um novo token de compra que não foi visto antes.
- Seu servidor recebe uma notificação de desenvolvedor em tempo real (RTDN, na sigla em inglês), que indica que é necessário usar o token de compra para ver as novas informações de assinatura.
- Não procure na API o status de assinatura regularmente. Por exemplo, não chame a API diariamente para verificar cada assinatura.
- Como você recebe uma RTDN quando a assinatura expira ou é renovada, não é necessário agendar uma chamada de API com base no prazo de validade programado.
API Reporting
A API Reporting é destinada a desenvolvedores que querem criar fluxos de trabalho automatizados sobre os dados do Play Console ou que usam dados do Play Console para relatórios e análises internos de negócios, possivelmente com outros conjuntos de dados. Isso dá a você acesso programático a dados e métricas pelo aplicativo para geração de relatórios internos, análise e automação.
A API Reporting oferece acesso a dados do Android vitals, incluindo taxa de falhas, taxa de ANR, problemas de ativação e bloqueio e wake lock e stack traces de erros.
Práticas recomendadas
- Esta versão da API Reporting tem um limite padrão de 10 consultas por segundo. Veja sua cota na seção Cotas do Console do Google Cloud. Se você precisar exceder esse limite, use este formulário para enviar uma solicitação de cota.
API Reply to Reviews
A API Reply to Reviews permite que você veja o feedback dos usuários sobre seu app e responda a eles. É possível usar essa API para interagir com os usuários diretamente no kit de ferramentas de suporte ao cliente, como um sistema de CRM.
A API Reply to Reviews permite acessar o feedback somente para as versões de produção do app. Se você quiser ver o feedback sobre as versões Alfa ou Beta do seu app, use o Google Play Console. Além disso, a API mostra somente as avaliações que incluem comentários. Se um usuário avaliar seu app, mas não comentar, o feedback dele não vai poder ser acessado pela API.
API Permissions
A API Permissions permite que os desenvolvedores automatizem o gerenciamento de permissões no Play Console. Isso permite um controle flexível sobre quem tem acesso à sua conta de desenvolvedor, sem o envolvimento manual.
Com a API Permissions, você pode realizar funções administrativas como:
- remover o acesso dos usuários quando eles sai da empresa;
- conceder acesso a um app quando um usuário entra na equipe relevante.
API Voided Purchases
A API Voided Purchases oferece uma lista de pedidos associados a compras anuladas por um usuário. Use as informações desta lista para implementar um sistema de revogação que impede que o usuário acesse os produtos desses pedidos.
Essa API se aplica a pedidos únicos no app e assinaturas de apps.
Uma compra pode ser anulada das seguintes maneiras:
- O usuário solicita um reembolso pelo pedido.
- O usuário cancela o pedido.
- Um pedido estornado.
- O desenvolvedor cancela ou reembolsa um pedido. Observação: apenas pedidos revogados serão exibidos na API Voided Purchases. Se o desenvolvedor fizer o reembolso sem configurar a opção de revogação, os pedidos não aparecerão na API.
- O Google cancela ou reembolsa um pedido.
Com essa API, você ajuda a criar uma experiência mais equilibrada e justa para todos os usuários do seu app, principalmente se for um app de jogo.