Talvez você precise conferir e editar seu projeto dos serviços relacionados a jogos do Google Play 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 (Aumentar usuários > Serviços relacionados a jogos do Google Play > 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 ver ou alterar limites de uso do projeto ou para solicitar um aumento da cota, faça o seguinte:
- 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 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.
Conferir limites de taxas do OAuth e limites de novos usuários
Para conferir cotas especificamente relacionadas a taxas de concessão de autorização de usuário do OAuth e limites de novos usuários:
- Navegue até o Console do Google Cloud.
- Verifique se você selecionou o projeto correto.
- Acesse APIs e serviços > Tela de permissão OAuth.
- Nessa página, você pode conferir a taxa de concessão de autorização do usuário atual (ou taxa de concessão de token) e o limite total de novos usuários.
Se você notar que o jogo vai atingir o limite de taxa em breve, tome medidas para evitar interrupções ao jogador solicitando um aumento na cota do limite de taxa.
Para mais informações, consulte Limites de taxas de aplicativos OAuth.
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:
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 permissão 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 (Aumentar usuários > Serviços relacionados a jogos do Google Play > 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 do Cloud atual
Para conferir o projeto no Google Cloud, siga as etapas em Conferir o projeto.
Para configurar os serviços relacionados a jogos do Google Play (PGS, na sigla em inglês), é necessário um projeto exclusivo do Google Cloud. Se vários jogos compartilham um projeto do Cloud, é 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 do Google Cloud 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 realizar a mudança, é necessário adaptar 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
- Obtenha dinamicamente o ID do cliente da Web mais recente do servidor para concluir a mudança
- Pré-crie 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 realizar 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.