Para começar a fazer chamadas de API, configure o acesso à API na sua conta de desenvolvedor do Google Play. Isso envolve mudanças no Google Play Console e no Console do Google Cloud. As instruções a seguir explicam as etapas necessárias para começar a usar a API Google Play Developer.
- Criar um projeto do Google Cloud
- Ativar a API Google Play Developer para seu projeto do Google Cloud
- Configurar uma conta de serviço com as permissões apropriadas do Google Play Console para acessar a API Google Play Developer.
Criar um projeto do Google Cloud
Pule esta etapa caso já tenha um projeto do Google Cloud que você queira usar.
Crie um projeto no Console do Google Cloud.
Para saber mais sobre projetos do Google Cloud, consulte Como criar e gerenciar projetos.
Ativar a API
Depois de configurar o projeto do Google Cloud, você precisa ativar a API Google Play Developer.
Para fazer isso:
- Acesse a página da API Google Play Developer no Console do Google Cloud.
- Clique em Ativar.
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.
- No Console do Google Cloud, acesse Contas de serviço.
- Clique em Criar conta de serviço e siga as etapas.
- Acesse a página Usuários e permissões no Google Play Console.
- Clique em Convidar novos usuários.
Insira um endereço de e-mail para a conta de serviço no campo correspondente e conceda os direitos necessários para realizar ações.
Para usar as APIs do Google Play Faturamento, vai ser necessário conceder as seguintes permissões:
- Ver dados financeiros, pedidos e respostas à pesquisa de cancelamento
- Gerenciar pedidos e assinaturas
Clique em Convidar usuário.
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 mais informações, consulte Como configurar a tela de permissão OAuth.
- No Console do Google Cloud, acesse a página da tela de permissão OAuth.
- Siga as etapas para criar a tela de permissão OAuth.
Para criar um cliente OAuth, siga estas etapas:
- No Console do Google Cloud, acesse Credenciais.
- Clique em Criar credenciais > ID do cliente OAuth.
- Escolha o tipo de aplicativo e siga as instruções.
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 ao 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.