Talvez você precise conferir e editar seu projeto dos serviços do Google Play Games diretamente no Google Cloud.
Confira alguns cenários comuns:
- Você quer ativar outras APIs no projeto (como a do Google Drive)
- Você quer editar as informações de marca do jogo na caixa de diálogo do OAuth 2.0
- Você quer conferir as cotas da API e pedir mais (se necessário)
- Você quer editar URIs autorizados ou origens do JavaScript em IDs do cliente criados anteriormente
Conferir o projeto
Para conferir o projeto no Google Cloud, siga estas etapas:
- Selecione uma credencial para o jogo na página Configuração (Crescer usuários > serviços do Google Play Games > Configuração e gerenciamento > Configuração).
- Acesse a seção Autenticação e clique em Ver no Google Cloud.
Ajustar cotas de uso da API
No Google Cloud, você pode conferir os limites de uso da API configurados para o jogo no momento, além da quantidade de cota usada. Também é possível definir limites por usuário para evitar que um usuário abusivo (ou um cliente de jogo com bugs) esgote sua cota.
Para conferir ou mudar os limites de uso do projeto ou solicitar um aumento da cota, siga estas etapas:
- Se você ainda não tem uma conta de faturamento para o projeto, crie uma.
- Acesse a página "APIs ativadas" da biblioteca de APIs no Console de APIs e selecione uma API da lista.
- Para ver e mudar configurações relacionadas a cotas, selecione Cotas. Para ver as estatísticas de uso, selecione Uso.
"Usuários" são determinados com base no endereço IP do cliente que faz o pedido de cota. Por exemplo, se todos os pedidos vierem de um único servidor, talvez ele seja marcado por engano como um único usuário com spam. Para evitar isso, anexe um argumento userIp=x.x.x.x aos pedidos de endpoint de API.
Para saber mais sobre como definir cotas por usuário, consulte Como limitar o uso da API.
Além de um limite por usuário, há um limite diário para o aplicativo em toda a API dos serviços do Google Play Games. Normalmente, não é necessário mudar o limite pré-alocado. No entanto, se você antecipar um grande pico de volume (por exemplo, para um evento de lançamento futuro), é possível pedir uma cota extra clicando no link Solicitar mais.
Ativar outras APIs
Quando você cria seu ID do cliente no Play Console, a API dos serviços do Google Play Games é ativada automaticamente para o projeto. É possível ativar outras APIs do Google no Google Cloud.
Para ativar uma API no seu projeto, siga estas etapas:
Abra a biblioteca de APIs no Console de APIs do Google. Se necessário, selecione um projeto ou crie um novo. A biblioteca de APIs lista todas as APIs disponíveis agrupadas por família de produtos e popularidade.
Se a API que você quer ativar não estiver visível na lista, use a pesquisa para encontrá-la.
Selecione aquela que você quer habilitar e clique no botão Ativar.
Se necessário, ative o faturamento.
Se necessário, aceite os Termos de Serviço da API.
Modificar informações de marca
Para modificar as informações de marca (título, logotipo etc.) do jogo que aparecem na caixa de diálogo do OAuth 2.0, defina os atributos na tela de permissão do Google Cloud.
Para configurar a tela de permissão do projeto, faça o seguinte:
- Abra a página de consentimento no Play Console. Se necessário, selecione um projeto ou crie um novo.
- Preencha o formulário e clique em Salvar.
Modificar o tipo de usuário do OAuth
Se você estiver testando na faixa de teste de produção (Teste e lançamento > Produção) usando uma conta de teste pessoal, também será necessário configurar a definição de público-alvo do OAuth no Google Cloud como Externo. Para mais informações, consulte Gerenciar o público-alvo do app.
Modificar atributos relacionados ao ID do cliente
Para modificar atributos relacionados ao seu ID do cliente do OAuth 2.0 (origens e URLs de redirecionamento para um app da Web etc.), siga estas etapas:
- Abra o Play Console e navegue até o jogo.
- Selecione uma credencial para o jogo na página Configuração (Crescer usuários > serviços do Google Play Games > Configuração e gerenciamento > Configuração).
- Role até a parte de baixo da seção Autenticação e clique em Ver no Google Cloud.
- No Google Cloud, selecione seu projeto.
- Na barra lateral à esquerda, selecione APIs e autorização. Confira se o status da API dos serviços relacionados a jogos do Google Play está ATIVADO na lista de APIs mostrada.
- Na barra lateral à esquerda, selecione Apps registrados.
- Expanda a seção "ID do cliente do OAuth 2.0" e encontre o atributo para editar.
Migrar clientes OAuth de um projeto na nuvem atual
Para conferir o projeto no Google Cloud, siga as etapas em Conferir o projeto.
Para configurar os serviços do Google Play Games (PGS), é necessário um projeto exclusivo do Google Cloud. Se vários jogos compartilharem um projeto na nuvem, será necessário migrar os clientes OAuth do Android para projetos independentes para garantir a configuração adequada.
No exemplo anterior, o jogo 1 e o jogo 2 criaram clientes da Web e do Android em um único projeto na nuvem do Google para o recurso Fazer login com o Google. Precisamos mover os clientes da Web e do Android do jogo 2 do projeto atual do Google Cloud legado para um novo projeto do Google Cloud de destino.
Etapa 1: preparação do back-end
Antes de fazer a mudança, adapte o back-end e os clientes para lidar com a existência simultânea de IDs de clientes da Web antigos e novos.
- Configuração do lado do servidor: se o servidor validar o ID do cliente da Web no token de ID, será necessário atualizar a lógica do lado do servidor para oferecer suporte simultâneo a tokens de ID emitidos pelos clientes antigos no projeto do Cloud legado e pelos novos clientes que você precisa gerar no projeto do Cloud de destino.
- Configuração do lado do cliente: o aplicativo cliente precisa oferecer suporte a
vários IDs de clientes da Web para fazer login usando o novo ID do cliente da Web ao
mudar. Você pode usar qualquer um dos seguintes métodos:
- Dois IDs de clientes da Web integrados no app cliente, mudando para o novo ID do cliente da Web quando o ID do cliente antigo expirar
- Obter dinamicamente o ID do cliente da Web mais recente do servidor para concluir a mudança
- Pré-criar clientes da Web: no projeto de destino, é necessário criar um novo cliente da Web com antecedência para evitar possíveis atrasos durante a mudança atômica.
Etapa 2: configurar novos clientes OAuth da Web e do Android no Google Cloud correto
Etapa 2.1: crie um novo cliente OAuth da Web para o jogo 2 no projeto do Google Cloud de destino:
Etapa 2.2: aviso: a modificação do cliente Android impedirá que os usuários do jogo façam login no jogo usando o recurso Fazer login com o Google. Portanto, é necessário executar a etapa 2.3 imediatamente após a etapa 2.2. Recomendamos abrir duas páginas da Web simultaneamente para que as operações minimizem o intervalo de tempo entre a modificação e a recriação.
Mude o nome do pacote do cliente Android do jogo 2 no projeto do Google Cloud legado para um valor inválido, como com.noexist.none.
Etapa 2.3: crie imediatamente um novo cliente Android para o jogo 2 com a mesma impressão digital SHA-1 e o mesmo nome de pacote do jogo 2 no projeto do Google Cloud de destino:
Etapa 3: implantação da configuração em tempo real
Depois de criar o novo cliente Android no projeto de destino , faça o seguinte imediatamente:
- Redirecionar clientes: use o mecanismo de configuração dinâmica (como a Configuração remota) para mudar imediatamente o aplicativo cliente para que ele comece a usar o novo ID do cliente da Web.
- Manter os clientes antigos: mantenha os clientes OAuth antigos como uma opção de fallback para reverter para o login do cliente OAuth anterior se ocorrer algum problema.