Introdução à API Publishing dos serviços relacionados a jogos do Google Play

Para começar a fazer chamadas para a API Publishing, é preciso fazer a vinculação de um projeto de API diretamente no Google Play Console e ativar a API Publishing para ele. Quando o projeto de API estiver configurado, ele vai poder ser usado para gerenciar outros projetos de jogos.

A API Publishing só pode ser configurada pelo proprietário da sua conta de desenvolvedor do Google Play. As instruções abaixo explicam como:

  • Configurar um projeto de API novo ou existente
  • Gerenciar clientes OAuth
  • Usar uma conta de serviço para acessar a API Publishing

Configurar seu projeto de API

Antes de acessar a API Publishing, vincule o Google Play Console a um projeto de API. Na maioria dos casos, é recomendável criar um novo projeto de API, mas usuários atuais da API Google Play Developer Publishing podem fazer a vinculação a um projeto de API existente. Cada projeto de API só pode ser vinculado a uma conta do Google Play Console.

Criar um novo projeto de API

  1. Acesse a página Acesso à API no Google Play Console.
  2. Aceite os Termos de Serviço.
  3. Clique em Criar novo projeto. Um projeto de API será gerado e vinculado ao Google Play Console automaticamente.
  4. Defina a opção Game Services Publishing API como Ativada.

Seu projeto de API agora está configurado para acessar a API Publishing.

Usar um projeto de API existente

Se você já for usuário da API Google Play Developer, siga estas instruções para configurar seu projeto de API. Se o projeto de API que você quer configurar não estiver listado, verifique se a conta do Google Play Console está designada como "Proprietário" e se a API Google Play Developer está ativada.

  1. Acesse a página Acesso à API no Google Play Console.
  2. Aceite os Termos de Serviço da API.
  3. Escolha o projeto que quer configurar.
  4. Clique em Vincular. Agora o Google Play Console está vinculado ao projeto de API.
  5. Defina a opção Game Services Publishing API como Ativada.

Seu projeto de API agora está configurado para acessar a API Publishing.

Configurar clientes de acesso à API

A API Publishing é acessada usando um cliente OAuth ou uma conta de serviço.

Usar clientes OAuth

Você pode permitir que os usuários realizem ações pela API Publishing usando as próprias credenciais com um cliente OAuth.

As ações de um usuário são limitadas às permitidas pela página Contas e direitos do usuário no Google Play Console.

  1. Acesse a página Acesso à API no Google Play Console.
  2. Em Clientes OAuth, clique em Criar cliente OAuth.
  3. Configure as informações de marca do seu produto e clique em Continuar.
  4. Clique em Criar ID do cliente.

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

Usar uma conta de serviço

Também é possível criar uma conta de serviço para acessar a API Publishing com um servidor de build, sem fornecer suas credenciais pessoais de usuário:

  1. Acesse a página Acesso à API no Google Play Console.
  2. Em Contas de serviço, clique em Criar conta de serviço.
  3. Siga as instruções na página para criar sua conta de serviço.
  4. Depois de criar a conta de serviço no Google Developers Console, clique em Concluído. A página Acesso à API é atualizada automaticamente, e sua conta de serviço vai ser listada.
  5. Clique em Conceder acesso para fornecer à conta de serviço os direitos necessários para realizar ações.

Para mais informações, consulte Usar o OAuth 2.0 em aplicativos de servidor para servidor.

Acessar a API Publishing dos serviços relacionados a jogos do Google Play

É possível acessar a API Publishing diretamente por HTTP. Para mais informações, consulte a referência da API Publishing e o app de exemplo (em inglês).