Primeiros passos

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. As instruções a seguir explicam o que fazer:

  • Configurar um projeto do Google Cloud novo ou existente
  • Gerenciar clientes OAuth
  • Usar uma conta de serviço para acessar a API Google Play Developer
  • Acessar APIs especializadas para analisar seu app

Vincular a 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 precisam compartilhar o mesmo projeto do Google Cloud.

Criar um novo projeto

  1. Acesse a página Acesso à API no Google Play Console.
  2. Aceite os Termos de Serviço.
  3. Clique em Criar novo projeto.

O projeto do Google Cloud é gerado e vinculado automaticamente ao Google Play Console.

Uso de um projeto existente

Se você já é usuário da API Google Play Developer, pode vincular ao projeto de API existente seguindo estas etapas:

  1. Acesse a página Acesso à API no Google Play Console.
  2. Aceite os Termos de Serviço da API.
  3. Selecione o projeto a ser vinculado.

    Caso seu projeto não esteja listado, verifique se:

    • sua conta do Google Play Console foi designada como proprietária;
    • a API Google Play Developer está ativada no projeto.
  4. Clique em Vincular projeto existente.

Configurar OAuth e contas de serviço

É necessário configurar o acesso à API Google Play Developer com um cliente OAuth ou com 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 Criar nova conta de serviço.
  3. Siga as instruções na página 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 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 será atualizada automaticamente, e sua conta de serviço será 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 mais informações, consulte Usar o OAuth 2.0 para aplicativos de servidor para servidor.

Uso de clientes OAuth

É possível permitir que os usuários realizem ações na API com as próprias credenciais usando um cliente OAuth. As ações dos usuários são limitadas às 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. Saiba mais.

  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. Após terminar, clique em Atualizar permissão OAuth. A seção será atualizada, e você não verá mais a mensagem sobre as informações de marca.

Para criar um cliente OAuth pelo 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ágina Acesso à API será atualizada automaticamente, e seu cliente OAuth será 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.

Encontrar o 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 aplicativo 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.