Register now for Android Dev Summit 2019!

API Google Play Developer

A API Google Play Developer é um serviço da Web baseado em REST que permite realizar tarefas de publicação e gerenciamento de aplicativos. É possível usar essa API para integrar operações de publicação ao seu processo de gestão de lançamento.

Nem todos os desenvolvedores precisarão usar essas APIs. Na maioria dos casos, você continuará gerenciando seus aplicativos diretamente pelo Google Play Console. No entanto, se você tiver muitos APKs para gerenciar ou tiver que acompanhar as compras e assinaturas de usuários, essa API poderá ser muito útil.

Com a API Google Play Developer, você pode automatizar várias tarefas de gerenciamento de aplicativos, incluindo:

  • carregar e lançar novas versões do aplicativo;
  • editar as listagens do aplicativo no Google Play Store, incluindo textos e gráficos localizados;
  • gerenciar seu catálogo de produtos no aplicativo, o status de compra dos produtos e assinaturas do aplicativo.

A API Google Play Developer permite que você se concentre em projetar e desenvolver o aplicativo, gastando menos tempo e esforço no gerenciamento das versões, mesmo durante uma expansão a novos mercados.

A API Google Play Developer contém dois componentes:

  • A API Publishing permite fazer upload e publicar aplicativos, 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".

API Publishing

Com a API Google Play Developer Publishing, é possível automatizar tarefas comuns relacionadas à distribuição de apps. Ela fornece funções semelhantes àquelas disponibilizadas para um desenvolvedor por meio do Play Console, como:

  • carregar novas versões de um aplicativo;
  • liberar aplicativos, atribuindo APKs a várias faixas (alfa, beta, lançamento gradual ou produção);
  • criar e modificar listagens 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 edits, que emprega uma abordagem transacional para fazer mudanças. Você agrupa várias alterações em uma única edição de rascunho e, em seguida, confirma as alterações de uma só vez. (nenhuma alteração surte efeito até que a edição seja confirmada).

Observação: nem todos os desenvolvedores precisarão usar essa API. Todas as funcionalidades fornecidas pela API também são encontradas no Google Play Console. No entanto, essa API permite integrar o aplicativo e o processo de atualização de listagem às ferramentas que você já tem, o que será muito útil para alguns desenvolvedores. Em particular, caso você tenha muitos APKs para gerenciar ou listagens em vários locais diferentes, talvez essa API não seja vantajosa.

API Subscriptions and In-App Purchases

Essa API permite gerenciar o catálogo de produtos e assinaturas internos do aplicativo. 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 aplicativo, código de 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.

É possível usar a API Purchase Status de várias maneiras, como para relatar e reconciliar pedidos individuais e para 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.

Observação: a API Subscriptions and In-App Purchases não usa o novo recurso transacional "edits" empregado pela API Publishing. Os métodos para os recursos Inappproducts, Purchases.products e Purchases.subscriptions entram em vigor imediatamente. Cada página de referência da API do recurso indica especificamente se os métodos para esse recursos utilizam o modelo de "edits".

A API Purchase Status é parte da versão 2.0 da API Google Play Developer, disponível pelo Google Developers Console.

Usar a API

Para começar a fazer chamadas para a API, configure e gerencie a API Google Play Developer diretamente no Google Play Console. A API só pode ser gerenciada pelo proprietário da sua conta de desenvolvedor do Google Play.

Para acessá-la, você precisa fazer o seguinte:

  1. Configurar um projeto de API novo ou existente.
  2. Configurar um ou mais clientes autorizados, que podem ser:

Para ver todos os detalhes, consulte a página Primeiros passos da API Google Play Developer.

Edições em etapas

Os métodos de edição da API Google Play Developer Publishing permitem que você prepare e confirme alterações nos seus aplicativos do Google Play. Quando a atualização estiver pronta, será possível implantá-la com uma única operação. As mudanças possíveis incluem:

  • atualizar um ou mais APKs;
  • atribuir diferentes APKs a diferentes "faixas": alfa, beta, lançamento gradual e produção;
  • criar e modificar listagens localizadas para o aplicativo na loja;
  • carregar capturas de tela e outras imagens para a listagem do aplicativo na loja.

Depois que todas as alterações necessárias tiverem sido preparadas, elas serão confirmadas com uma única operação.

Para ver todos os detalhes sobre edições em etapas, consulte a página Edições da API Google Play Developer.

Observação: o novo recurso transacional "edits" é usado apenas pela API Publishing. Os métodos para a API Subscriptions and In-App Purchases entram em vigor imediatamente. Cada página de referência da API do recurso indica especificamente se os métodos para esse utilizam o modelo de "edits".

Usar a API de forma eficiente

O acesso à API Google Play Developer é regulamentado para garantir um ambiente de alto desempenho a todos os aplicativos que a utilizam (conforme descrito em Cota). Embora seja possível solicitar uma cota diária maior para seu aplicativo, é altamente recomendável que você minimize seu acesso usando estas técnicas:

  • Limitar o número de atualizações do aplicativo: não publique atualizações alfa ou beta com mais frequência do que uma vez por dia. Aplicativos de produção necessitam de atualização 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. É claro que, se houver um grande problema com seu aplicativo, vá em frente e corrija-o.
  • Consultar a API Purchase Status somente para novas compras: na compra, seu aplicativo pode passar o token de compra e outros detalhes para seus servidores de back-end, que podem usar a API Purchase Status para confirmar a compra.
  • Armazenar em cache detalhes de compra nos seus servidores: na medida do possível, armazene em cache os detalhes de compra de produtos e assinaturas no aplicativo nos seus servidores de back-end. Se seu aplicativo entrar em contato com os servidores de back-end no tempo de execução para verificar a validade da compra, o servidor poderá verificar a compra com base nos detalhes armazenados em cache, minimizar o uso da API Purchase Status e fornecer a resposta mais rápida possível (e melhor experiência) para o usuário.
  • Armazenar a validade da assinatura nos seus servidores: é necessário que seus servidores usem a API Purchase Status para consultar a data de validade de novos tokens de assinatura e, em seguida, armazenar a data de validade localmente. Isso permite que você verifique o status das assinaturas somente após o vencimento (veja abaixo).
  • Consultar o status da assinatura apenas no vencimento: depois que o servidor consultar a data de validade dos tokens de assinatura, ele não precisará consultar de novo os servidores do Google Play sobre o status da assinatura até que ela esteja chegando ou tenha passado a data de validade. Normalmente, os servidores executariam uma consulta em lote todo dia para verificar o status de vencimento de assinaturas e, em seguida, atualizariam o banco de dados. Algumas considerações:
    • Os servidores não devem consultar todas as assinaturas todos os dias.
    • Não é necessário que os servidores consultem o status da assinatura dinamicamente, com base em solicitações individuais do seu aplicativo Android.

Ao seguir essas instruções gerais, sua implementação oferecerá o melhor desempenho possível para os usuários.

Cota

Os aplicativos que usam a API Google Play Developer estão limitados a uma cota de uso inicial de cortesia de 200.000 solicitações por dia (por aplicativo). É uma quantidade suficiente para fornecer acesso a atividades de publicação e necessidades normais de validação de assinatura.

Se você precisar solicitar um limite maior para seu aplicativo, use o link "Solicitar mais" no painel Cotas do Google Developers Console.