Como começar

Para começar a fazer chamadas de API, configure o acesso à API na sua conta de desenvolvedor do Google Play. Isso envolve alterações no Google Play Console e no Console do Google Cloud. As instruções a seguir explicam as quatro etapas necessárias para começar a usar a API Google Play Developer.

  1. Vincule sua conta de desenvolvedor a um projeto novo ou atual do Google Cloud.
  2. Ative a API Google Play Developer para seu projeto vinculado do Google Cloud.
  3. Autorize uma chave de API para a API Google Play Developer no seu projeto vinculado do Google Cloud.
  4. Configure uma conta de serviço com as permissões apropriadas do Google Play Console para acessar a API Google Play Developer.

Vincular sua conta e o projeto

Antes de acessar a API Google Play Developer, vincule sua conta de desenvolvedor do Google Play a um projeto do Google Cloud. Na maioria dos casos, recomendamos criar um novo projeto do Google Cloud dedicado à sua conta de desenvolvedor do Google Play, mas é possível vincular um projeto existente. Cada conta de desenvolvedor do Google Play só pode ser vinculada a um único projeto do Google Cloud. Caso você tenha vários apps na mesma conta de desenvolvedor, todos terão que compartilhar o mesmo projeto do Google Cloud.

Criar um novo projeto

  1. Acesse a página Acesso à API no Google Play Console.
  2. Clique em Criar novo projeto.

O projeto do Google Cloud é criado e vinculado automaticamente à sua conta de desenvolvedor do Google Play.

Usar um projeto atual

Se você já é usuário do Console do Google Cloud, pode vincular o projeto atual do Google Cloud seguindo estas etapas:

  1. Acesse a página Acesso à API no Google Play Console.
  2. Selecione o projeto a ser vinculado. Se o projeto não estiver listado, confira se a conta de usuário está designada como Proprietário no projeto do Google Cloud que você quer vincular.
  3. Clique em Vincular projeto existente.

Ativar a API

Depois de configurar o projeto do Google Cloud vinculado, é necessário ativar a API Google Play Developer. Para fazer isso, você precisa ser proprietário do projeto do Google Cloud.

  1. Acesse a página Acesso à API no Google Play Console.
  2. Em APIs, encontre a API Google Play Developer e clique em Ativar.

Essa ação atualiza o projeto do Google Cloud, e a alteração entra em vigor imediatamente.

Autorizar uma chave de API

Para usar a API, você precisa ter uma chave no projeto vinculado do Google Cloud que esteja autorizada a usar a API Google Play Developer. Essa configuração é feita no Google Play Console.

Configurar OAuth e contas de serviço

É necessário configurar o acesso à API Google Play Developer com um cliente OAuth ou uma conta de serviço. Na maioria dos casos, é preciso usar uma conta de serviço para acessar a API.

As contas de serviço precisam ser usadas em um ambiente seguro, como seu servidor. As credenciais da conta de serviço precisam ser gerenciadas com segurança para que não sejam reveladas a pessoas não autorizadas a usar a API.

O ID do cliente OAuth deve ser usado se você precisar acessar a API em nome de um usuário individual. Por exemplo, caso seu site precise acessar a API Google Play Developer do cliente da Web em nome do usuário, é possível usar o ID do cliente. O usuário será autenticado com a Conta do Google em vez da conta de serviço. Isso permite que você faça chamadas de API em nome de um usuário sem comprometer as credenciais da conta de serviço.

  • Conta de serviço: um serviço de software seguro acessará a API (mais comum)
  • Clientes OAuth: um usuário acessará a API.

Usar uma conta de serviço

É possível criar uma conta de serviço no Google Play Console.

  1. Acesse a página Acesso à API no Google Play Console.
  2. Em Contas de serviço, clique em Saiba como criar contas de serviço.
  3. Siga as instruções para criar sua conta de serviço.

    Durante o processo de criação, você precisa conceder à sua conta de serviço acesso ao projeto do Google Cloud para que ele apareça no Google Play Console.

  4. Depois de criar a conta de serviço no Google Play Console, clique em Concluído. A seção "Contas de serviço" da página Acesso à API é atualizada automaticamente, e sua conta de serviço aparece listada.

  5. Clique em Conceder acesso para fornecer à conta de serviço os direitos necessários para realizar ações.

    Para usar as APIs do Google Play Faturamento, será necessário conceder as seguintes permissões:

    • Ver dados financeiros, pedidos e respostas à pesquisa de cancelamento
    • Gerenciar pedidos e assinaturas

Neste ponto, você conseguirá acessar a API Google Play Developer na conta de serviço. Para ver outras informações, consulte Usar o OAuth 2.0 para aplicativos de servidor para servidor.

Usar clientes OAuth

É possível permitir que os usuários realizem ações na API com as próprias credenciais usando um cliente OAuth. Os usuários só podem executar as ações permitidas na página Usuários e permissões no Google Play Console.

Antes de criar clientes OAuth, você precisa configurar as informações de marca do produto. Para ver mais informações, consulte Como configurar a tela de permissão OAuth.

  1. Acesse a página Acesso à API no Google Play Console.
  2. Em Clientes OAuth, clique em Configurar a tela de permissão OAuth.
  3. Configure as informações de marca do seu produto.
  4. Quando terminar, clique em Atualizar permissão OAuth. A seção é atualizada, e a mensagem sobre as informações de marca não aparece mais.

Para criar um cliente OAuth usando o Google Play Console, faça o seguinte:

  1. Acesse a página Acesso à API no Google Play Console.
  2. Em Clientes OAuth, clique em Criar um cliente OAuth.
  3. Siga as instruções na página para criar o cliente OAuth.
  4. Depois de criar o cliente OAuth no Google Play Console, clique em Concluído. A seção Clientes OAuth da páginaAcesso à API é atualizada automaticamente, e seu cliente OAuth aparece listado.

    Às vezes, o novo cliente OAuth não aparece na página imediatamente. Nesse caso, clique em Atualizar clientes OAuth.

Os detalhes do novo cliente OAuth são exibidos em uma lista nessa página.

Outras informações

Use as dicas e sugestões a seguir para começar a usar a API no Google Play.

Encontrar seu ID de desenvolvedor

Algumas APIs exigem que você informe um ID de desenvolvedor do Google Play Console, um número longo atribuído quando a conta de desenvolvedor do Google Play foi criada. O ID do desenvolvedor pode ser encontrado no URL de praticamente qualquer página do Google Play Console, como a página de acesso à API.

Considere o URL do Google Play Console, por exemplo:

https://play.google.com/console/developers/1234567890123456789/api-access

No URL acima, o ID do desenvolvedor é 1234567890123456789.

Observação: se um app for transferido de uma conta de desenvolvedor do Google Play a outra, o ID do desenvolvedor associado a ele mudará. Isso significa que, após a conclusão da transferência, será necessário usar o ID da nova conta de desenvolvedor do Google Play nas chamadas de API desse app.

APIs especializadas

A Google Play Developer API contém várias APIs especializadas que permitem que você faça tipos específicos de análise no seu app:

API Reply to Reviews
Permite visualizar e responder o feedback de usuários sobre o app.
API Voided Purchases
Permite revogar o acesso a produtos no app associados a compras anuladas por um usuário.

Bibliotecas de clientes

Fornecemos bibliotecas de clientes que podem ser usadas para acessar APIs REST de maneira programática. Para saber mais, confira Bibliotecas de clientes e amostras de códigos.