O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

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 apps. É possível usar essa API para integrar operações de publicação ao seu processo de gerenciamento de lançamento.

Nem todos os desenvolvedores precisarão usar essas APIs. Na maioria dos casos, você continuará gerenciando seus apps 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, é possível automatizar várias tarefas de gerenciamento de apps, incluindo:

  • carregar e lançar novas versões do app;
  • editar as listagens do app na 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 app.

A API Google Play Developer permite que você se concentre em projetar e desenvolver o app, gastando menos tempo e esforço no gerenciamento dos lançamentos, mesmo durante uma expansão para novos mercados.

A API Google Play Developer contém dois componentes:

  • 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".

API Publishing

Com a API Publishing do Google Play Developer, é 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 app;
  • liberar apps, 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. Agrupe várias mudanças em uma única edição de rascunho e, em seguida, confirme as mudanças de uma só vez. Nenhuma mudança tem efeito até que a edição seja confirmada.

Observação: nem todos os desenvolvedores precisarão usar essa API. Todas as funcionalidades oferecidas pela API também estão disponíveis no Google Play Console. No entanto, essa API permite integrar o app 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 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.

É 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" usado 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 recurso utilizam o modelo de "edits".

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

Como usar a API

Para começar a fazer chamadas de 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 já existente
  2. Configure 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 apps do Google Play. Quando a atualização estiver pronta, será possível implantá-la em uma única operação. As mudanças possíveis incluem:

  • Atualização de um ou mais APKs
  • Atribuição de diferentes APKs a diferentes "faixas": alfa, beta, lançamento gradual e produção
  • Criação e modificação de listagens localizadas para o app na loja
  • Upload de capturas de tela e outras imagens para a listagem do app na loja

Depois que todas as mudanças necessárias tiverem sido preparadas, elas serão confirmadas em 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 recurso transacional "edits" é usado apenas pela API Publishing. Os métodos da 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 recurso utilizam o modelo de "edits".

Como usar a API de forma eficiente

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

Publicação

  • Limitar o número de atualizações do app: não publique atualizações alfa ou beta mais de uma vez por dia. Apps de produção necessitam de atualização com menor frequência. 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 o app, vá em frente e corrija-o.

Compras únicas

  • Consultar a API Purchase Status somente para novas compras: na compra, seu app 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 app nos seus servidores de back-end. Se o app 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 uma melhor experiência) para o usuário.

Assinaturas

  • Armazenar 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.

    Observe também o seguinte:

    • Não pesquise a API para verificar o status da 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 na hora de expiração agendada.

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

Cota

Os apps 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 app). É 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 app, use o link "Solicitar mais" no painel Cotas do Google Developers Console.