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

Este documento mostra como usar o Google Play Console para configurar os serviços relacionados a jogos do Google Play para seu jogo Android. O Google Play Console oferece um local centralizado para você gerenciar serviços de jogo 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 nome e 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: Fazer login no Google Play Console

Para fazer login, acesse o Google Play Console. Caso ainda não tenha se registrado no Google Play Console, você 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. Veja mais detalhes aqui.
2. Navegue até Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Configuração.

3. Especifique se o jogo já usa APIs do Google, como a do Firebase. É muito importante escolher a opção correta.

   • Se você estiver criando um jogo do zero ou se nunca tiver configurado APIs do Google para ele, escolha Não, meu jogo não usa APIs do Google. Digite o nome do jogo e clique em Criar.
   • Se você já tiver configurado um ou mais jogos para este jogo, escolha Sim, meu jogo já usa APIs do Google. Você verá uma lista de projetos do Console do Google Cloud em que está listado como desenvolvedor. Selecione o projeto na lista e clique em Usar.
   • Se você quiser usar um projeto existente dos serviços relacionados a jogos do Google Play, escolha Usar um projeto existente. Você verá uma lista de projetos de serviços relacionados a jogos do Google Play para sua conta. Selecione o projeto de jogo correto da lista e clique em Usar. Essa não é uma escolha comum, mas você pode fazer isso se estiver criando um novo jogo no Play Console para mudar o nome do pacote ou se tiver versões sem custo financeiro e pagas com diferentes nomes de pacote.

4. Um projeto de jogo dos serviços relacionados a jogos do Google Play vai ser criado, e uma entrada correspondente vai ser criada no Console do Google Cloud.

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

   • Apenas o nome de exibição é obrigatório para testes. Os outros campos precisam ser preenchidos antes de publicar o jogo.
   • O nome de exibição e a descrição do jogo precisam corresponder aos que você configurou para a página "Detalhes do app".
   • Para conferir diretrizes de criação de recursos gráficos, consulte o guia do Google Play para desenvolvedores e as Diretrizes de imagens em destaque do Google Play.

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:

a. Configurar a tela de permissão OAuth

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.

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

Observação: confira se a tela de consentimento está disponível para todos os usuários do jogo. A lista final de escopos precisa incluir games, games_lite e drive.appdata. Nenhum deles exige verificação de apps. Recomendamos publicar a tela de permissão imediatamente. Se isso não for possível, deixe a tela de permissão disponível aos testadores para que eles façam login no jogo.

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:

b. Criar uma credencial

Para autorizar o jogo a se comunicar com os serviços relacionados a jogos do Google Play, crie 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, caso o APK do jogo autentique o usuário e use as APIs PGS, ou uma credencial do servidor de jogos, caso o servidor use as APIs PGS. Siga as instruções específicas para seu tipo de credencial.

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

   Observação: no Windows, o keystore de depuração está localizado em C:\Users\<USERNAME>\.android\debug.keystore. No Mac ou Linux, o keystore de depuração normalmente fica localizado em ~/.android/debug.keystore.

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 de certificado de assinatura (SHA1).

7. Clique em Criar.

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

Aviso: anote o nome do pacote e o certificado de assinatura configurados nesta etapa. Usar um nome de certificado ou de pacote diferentes no aplicativo vai causar falhas de autenticação.

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 de configuração comuns

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

1. Configurar seu jogo com o Google Play Console

Se você criou um ID do cliente OAuth 2.0 para o app no Console do Google Cloud, os serviços relacionados a jogos do Google Play não vão saber que as conquistas e placares do jogo e o ID do cliente estão associados. 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 jogo no Google Play Console, use exatamente a mesma impressão digital de certificado e nome de pacote usados para publicar o app. Se houver alguma 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 app.

4. Ao desenvolver para Android, inclua o SDK do Play Games como um projeto de biblioteca, e não como um JAR independente.

Confira se o SDK do Google Play Services está referenciado como um projeto de biblioteca no seu projeto do Android. Caso contrário, isso pode causar erros quando o app não encontrar recursos do Google Play Services. Para aprender a 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 tiver publicado as mudanças nas configurações do jogo no Google Play Console, talvez encontre erros durante os testes se não tiver feito login com uma conta de testador permitida. Sempre ative a conta de editor do Google Play Console para teste. 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 fazem login com contas que não são de teste encontrem erros, já que o app não pode referenciar as configurações corretas do jogo. Ao lançar o jogo, publique as configurações 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 ver mais dicas, consulte:

• Guia de solução de problemas do Android: documentação do desenvolvedor que descreve como resolver problemas durante o desenvolvimento de jogos para Android.

Próximas etapas

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

Depois de concluir as tarefas de configuração iniciais descritas acima, é possível continuar a configuração de recursos para o jogo, como placares e conquistas. Para saber mais, consulte Ativar recursos.