Como configurar os serviços relacionados a jogos do Google Play

Este documento aborda como usar o Google Play Console para configurar os serviços relacionados a jogos do Google Play no seu jogo Android. O Google Play Console oferece um local centralizado para você gerenciar serviços relacionados a jogos e configurar metadados para autorizar e autenticar seu jogo.

Para adicionar seu jogo ao Google Play Console, siga estas etapas gerais:

  • Crie um projeto de jogo e especifique detalhes, como o nome e a descrição.
  • Crie e vincule as credenciais necessárias para autorizar e autenticar seu jogo nos serviços relacionados a jogos do Google Play.

Essas etapas são abordadas com mais detalhes nas seções abaixo.

Etapa 1. Faça login no Google Play Console.

Para fazer login, acesse o Google Play Console. Se você ainda não se registrou no Google Play Console, vai receber uma solicitação para fazer isso.

Etapa 2: Adicionar seu jogo ao Google Play Console

Para adicionar seu jogo, siga estas etapas:

  1. Crie um jogo no Play Console, caso ainda não tenha feito isso. Clique aqui para ver mais detalhes.
  2. Navegue até Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Configuração.
  3. Especifique qual projeto dos serviços relacionados a jogos do Google Play você quer usar: crie um do zero ou use um já existente.

    • Criar um novo projeto dos serviços relacionados a jogos do Google Play:é necessário ter um projeto na nuvem.

      • Se você já tiver um projeto de nuvem criado para este jogo, selecione seu projeto de nuvem na lista suspensa e selecione Usar.

      • Caso contrário, selecione Criar novo projeto na nuvem e siga as instruções para criar um novo projeto na nuvem para este jogo. Depois selecione Atualizar projetos na nuvem, escolha o projeto recém-criado na lista suspensa e clique em Usar.

    • Usar um projeto já existente dos serviços relacionados a jogos do Google Play:se você estiver criando um novo jogo no Play Console para mudar o nome do pacote existente ou se tiver versões sem custo financeiro e pagas do jogo com diferentes nomes de pacotes, use essa opção. Escolha o projeto dos serviços relacionados a jogos do Google Play e clique em Usar.

  4. Um projeto de jogo dos serviços relacionados a jogos do Google Play é criado, e as APIs desses serviços são ativadas automaticamente no projeto de nuvem selecionado.

  5. Na seção Propriedades, selecione Editar propriedades e adicione a descrição, a categoria e os recursos gráficos do jogo.

Etapa 3. Gerar um ID do cliente OAuth 2.0

Seu jogo precisa ter um ID do cliente OAuth 2.0 para ser autenticado e autorizado a chamar os serviços relacionados a jogos do Google Play. Para configurar uma credencial dos serviços relacionados a jogos do Google Play, que é a associação entre um ID do cliente e o jogo, use o Google Cloud Platform. Em seguida, use o Google Play Console para adicionar uma credencial, vinculando o ID do cliente ao jogo.

Para instruções mais detalhadas, consulte as próximas etapas:

Se você ainda não configurou a tela de permissão OAuth, a seção Credenciais vai mostrar uma mensagem pedindo para você fazer isso.

Solicitação para configurar a tela de permissão OAuth

Clique em Configurar. Isso vai abrir uma caixa de diálogo com mais instruções e um link direto para o Google Cloud Platform.

Configurar a tela de permissão OAuth. Configure e publique a página de configuração da tela de permissão OAuth no Google Cloud Platform. 1. Acesse a página de configuração da tela de permissão OAuth no Google Cloud Platform. 2. Disponibilize a tela de consentimento para todos no Google Play (externamente) ou somente para as pessoas na sua organização (internamente). 3. Dê um nome para o app, que precisa ser igual ao do jogo no Play Console. 4. Adicione os escopos: games, games_lite e drive.appdata. 5. Publique a tela de permissão. 6. Volte ao Play Console para confirmar a configuração.

Se você tiver concluído a configuração da tela de permissão OAuth, clique em Concluído. O Google Play Console vai ser atualizado automaticamente e, se a configuração tiver sido bem-sucedida, você vai poder criar uma credencial:

Criando uma credencial

b. Criar uma credencial

Para autorizar seu jogo a se comunicar com os serviços relacionados a jogos do Google Play, você precisa criar uma credencial com um ID do cliente OAuth2 autorizado.

Na seção Credenciais, clique em Adicionar credencial.

No assistente, escolha se você quer criar uma credencial do Android (se o APK do jogo autenticar o usuário e usar APIs PGS) ou uma credencial do servidor de jogos (se o servidor de jogos usar APIs PGS). Siga as instruções específicas do tipo de credencial desejado.

Android

Configurar detalhes da credencial

Confira se o nome no campo Nome corresponde ao do seu jogo. Escolha se você quer ativar o recurso Antipirataria.

Configurar autorização

Em seguida, escolha um ID do cliente OAuth para usar no projeto do jogo. Se você já tem IDs do cliente OAuth2, escolha um. No entanto, normalmente você vai precisar criar um novo. Clique em Criar um cliente OAuth. Isso vai abrir uma caixa de diálogo com links diretos e instruções para criar um ID do cliente OAuth no Google Cloud Platform.

  1. Selecione Android como o tipo de aplicativo.
  2. Digite o nome do jogo no campo Nome.
  3. Digite o nome do pacote do aplicativo Android no campo correspondente.
  4. Abra um terminal e execute o utilitário Keytool para receber as impressões digitais SHA1 dos certificados de versão e depuração.

    Para encontrar a impressão digital do certificado de versão, execute este comando:

    keytool -list -keystore <path-to-production-keystore> -v

    Para encontrar a impressão digital do certificado de depuração, execute este comando:

    keytool -list -keystore <path-to-debug-keystore> -v

  5. O utilitário keytool solicita que você insira uma senha para o armazenamento de chave. A senha padrão do keystore de depuração é android. Em seguida, a keytool vai mostrar a impressão digital no terminal.

  6. Cole a impressão digital SHA1 no campo Impressão digital do certificado de autorização (SHA1).

  7. Clique em Criar.

Para mais informações sobre o OAuth 2.0 no Android, consulte Como autenticar em serviços OAuth2.

Depois de clicar em Concluído na caixa de diálogo, os IDs do cliente disponíveis vão ser atualizados. Escolha a credencial criada no menu suspenso e clique em Salvar alterações. Isso cria a credencial como um rascunho, permitindo que você faça a autenticação dos serviços relacionados a jogos do Google Play.

Crie duas credenciais: uma com a impressão digital do certificado de versão e outra com a impressão digital do certificado de depuração. Use o mesmo nome de pacote para as duas. Isso permite que os serviços relacionados a jogos do Google Play reconheçam chamadas dos APKs vinculados que são assinados com um desses certificados. Para mais informações sobre a assinatura de certificados para Android, consulte Assinar o app.

Servidor de jogos

Configurar detalhes da credencial

Confira se o nome no campo Nome corresponde ao do seu jogo.

Configurar autorização

Em seguida, escolha um ID do cliente OAuth para usar no projeto do jogo. Se você já tem IDs do cliente OAuth2, escolha um. No entanto, normalmente você vai precisar criar um novo. Clique em Criar um cliente OAuth. Isso vai abrir uma caixa de diálogo com links diretos e instruções para criar um ID do cliente OAuth no Google Cloud Platform.

  1. Selecione Aplicativo da Web como o tipo de aplicativo.
  2. Digite o nome do jogo no campo Nome.
  3. Clique em Criar.

Para mais informações sobre o OAuth 2.0 no Android, consulte Como autenticar em serviços OAuth2.

Depois de clicar em Concluído na caixa de diálogo, os IDs do cliente disponíveis vão ser atualizados. Escolha a credencial criada no menu suspenso e clique em Salvar alterações. Isso cria a credencial como um rascunho, permitindo que você faça a autenticação dos serviços relacionados a jogos do Google Play no seu servidor de jogos. Consulte Como ativar o acesso do lado do servidor nos serviços relacionados a jogos do Google Play para mais informações sobre o uso desses serviços no seu servidor de jogos.

Como evitar problemas comuns de configuração

Para evitar erros comuns de configuração, siga estas recomendações ao configurar seu jogo para usar os serviços relacionados a jogos do Google Play.

1. Configurar o jogo com o Google Play Console
Se você criou um ID do cliente Oauth 2.0 para seu app no Console do Google Cloud, os serviços relacionados a jogos do Google Play não saberão sobre a associação entre a conquista, os placares e o ID do cliente. Para criar essa associação, crie uma credencial usando o ID do cliente OAuth 2.0, conforme descrito em Criar uma credencial.
2. Use o ID do aplicativo correto no Android
O ID do aplicativo é um recurso de string obrigatório que precisa ser referenciado no manifesto do Android. A string do ID do aplicativo consiste apenas nos dígitos (normalmente 12 ou mais) no início do ID do cliente fornecido pelo Google Play Console. O ID do aplicativo fica na parte de cima da página Configuração e é rotulado como ID do projeto abaixo do nome do jogo.
3. Assine o APK com o certificado correto
Ao vincular seu app Android ao seu jogo no Google Play Console, use exatamente o mesmo nome de pacote e impressão digital do certificado usados para publicar o app. Se houver uma incompatibilidade, as chamadas para os serviços relacionados a jogos do Google Play vão falhar. Crie dois IDs do cliente, um com a impressão digital do certificado de lançamento e outro com a impressão do certificado de depuração, e use o mesmo nome de pacote para os dois. Para saber mais sobre como especificar o certificado de assinatura no Google Play Console, consulte Assinar o aplicativo.
4. Ao desenvolver para o Android, inclua o SDK do Play Games como um projeto de biblioteca, não como um JAR independente
Confira se o SDK do Google Play Services está referenciado como um projeto de biblioteca no seu projeto Android. Caso contrário, isso poderá levar a erros quando o app não encontrar recursos do Google Play Services. Para saber como configurar seu projeto do Android para usar o Google Play Services, consulte Como configurar o Google Play Services.
5. Faça login com uma conta de testador durante o desenvolvimento
Se você não publicou as mudanças nas configurações do jogo no Google Play Console, é possível que ocorram erros durante os testes se você não tiver feito login com uma conta de testador permitida. Sempre ative sua conta de editor do Google Play Console para testes. Para aprender a gerenciar contas de testadores, consulte Como ativar contas para testes.
6. Publique a tela de permissão no Google Cloud Platform
Antes de publicar o app no Google Play Console, publique a tela de permissão no Google Cloud Platform. Sem esta etapa, o público não vai poder usar os recursos dos serviços relacionados a jogos do Google Play.
7. No lançamento, publique as configurações dos serviços relacionados a jogos do Google Play antes de publicar o jogo
Os desenvolvedores podem publicar o app acidentalmente sem publicar as configurações correspondentes dos serviços relacionados a jogos do Google Play. Isso pode fazer com que os jogadores que fizerem login com contas que não sejam de teste encontrem erros, já que o app não pode referenciar as configurações corretas do jogo. Ao lançar seu jogo, lembre-se de publicar as configurações dele usando a opção Publicar jogo no Google Play Console. Para aprender a publicar as mudanças, consulte Como publicar as mudanças no jogo.

Para mais dicas, consulte:

Próximas etapas

Antes de continuar, adicione contas de teste ao jogo, conforme descrito em Ativar contas para testes. Os usuários com contas de teste autorizadas terão acesso ao seu projeto não publicado dos serviços relacionados a jogos do Google Play e poderão testar se os serviços configurados estão funcionando corretamente.

Depois de concluir as tarefas de configuração inicial descritas acima, você pode prosseguir para configurar recursos para o jogo, como placares e conquistas. Para saber mais, consulte Ativar recursos.