Gerenciar as configurações do projeto dos serviços do Google Play Games no Google Cloud

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 seu projeto no Google Cloud:

1. Selecione uma credencial para o jogo na página Configuração (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Configuração).
2. Acesse a seção Autenticação e clique em Ver no Google Cloud.

Ajustar cotas de uso da API

No Google Cloud, é possível conferir os limites de uso da API configurados para o jogo e a 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 ver ou alterar limites de uso do projeto ou para solicitar um aumento da cota, faça o seguinte:

1. Se você ainda não tem uma conta de faturamento para o projeto, crie uma.
2. Acesse a página "APIs ativadas" da biblioteca de APIs no Console de APIs e selecione uma API da lista.
3. 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, ele poderá ser 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 relacionados a jogos do Google Play. 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 relacionados a jogos do Google Play é 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:

1. 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.

2. Se a API que você quer ativar não estiver visível na lista, use a pesquisa para encontrá-la.

3. Selecione aquela que você quer habilitar e clique no botão Ativar.

4. Se necessário, ative o faturamento.

5. 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 consentimento do projeto, faça o seguinte:

1. Abra a página de consentimento no Play Console. Se necessário, selecione um projeto ou crie um novo.
2. Preencha o formulário e clique em Salvar.

Modificar o tipo de usuário do OAuth

Se você estiver testando na faixa de teste Produção (Teste e lançamento > Produção) usando uma conta de teste pessoal, também é 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:

1. Abra o Play Console e navegue até o jogo.
2. Selecione uma credencial para o jogo na página Configuração (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Configuração).
3. Role até a parte de baixo da seção Autenticação e clique em Ver no Google Cloud.
4. No Google Cloud, selecione seu projeto.
5. 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.
6. Na barra lateral à esquerda, selecione Apps registrados.
7. 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 existente

Para conferir seu projeto no Google Cloud, siga as etapas em Conferir seu projeto.

Para configurar os serviços relacionados a jogos do Google Play (PGS), é necessário um projeto exclusivo do Google Cloud. Se vários jogos compartilharem um projeto do Cloud, migre os clientes OAuth do Android para projetos independentes e garanta 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 do Google Cloud para o Login do Google. Precisamos mover os clientes da Web e do Android do Jogo 2 do projeto legado atual do Google Cloud para um novo projeto de destino do Google Cloud.

Etapa 1: preparação do back-end

Antes de fazer a troca, adapte seu back-end e clientes para lidar com a existência simultânea de IDs de cliente 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 suportar simultaneamente tokens de ID emitidos pelos clientes antigos no projeto legado do Cloud e pelos novos clientes que você precisa gerar no projeto de destino do Cloud.
• Configuração do lado do cliente: seu aplicativo cliente precisa oferecer suporte a vários IDs de cliente da Web para fazer login usando o novo ID ao mudar. Você pode usar qualquer um dos seguintes métodos:
  • Dois IDs de cliente da Web integrados no app cliente, alternando para o novo ID de cliente da Web quando o antigo expirar
  • Obtenha dinamicamente o ID do cliente da Web mais recente do servidor para concluir a troca.
• Pré-criação de clientes da Web: no projeto de destino, crie um novo cliente da Web com antecedência para evitar possíveis atrasos durante a troca 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 na nuvem do Google de destino:

Etapa 2.2: Aviso: modificar o cliente Android vai impedir que os usuários do jogo façam login usando o recurso Fazer login com o Google. Portanto, é necessário realizar a etapa 2.3 imediatamente após a 2.2. Recomendamos abrir duas páginas da Web simultaneamente para que as operações minimizem o intervalo entre a modificação e a recriação.

Mude o nome do pacote do cliente Android do Jogo 2 no projeto legado do Google Cloud 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 nome do 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 destino, faça o seguinte:

• Redirecionar clientes: use seu 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.