Programação da descontinuação

Este documento lista a programação de descontinuação do SDK dos serviços do Google Play Games v1.

Após a descontinuação da API Google Sign-In (GSI) e o encerramento planejado, vamos descontinuar o SDK e as APIs dos serviços do Google Play Games v1. Migre seu jogo para o SDK dos serviços do Google Play Games v2 para receber os recursos mais recentes.

Confira as programações de descontinuação:

Data Marco da descontinuação
 Impacto Ação do desenvolvedor
Maio de 2026 Remoção da API GSI Se um jogo adicionar novos recursos, como LiveOps, missões ou mapas, que não dependam da autenticação do Google, exceto a API dos serviços do Google Play Games v1, esses recursos vão continuar funcionando.

Se o jogo usar um SDK de terceiros ou um SDK do Google que não seja dos serviços relacionados a jogos do Google Play v1 e que exija um upgrade de autenticação, a atualização para a versão mais recente desse SDK poderá causar erros de compilação.
  1. Siga o caminho de resolução mencionado aqui ao enfrentar um erro de compilação.
  2. Migre para os serviços do Google Play Games v2 de acordo com o caminho de solução mencionado aqui logo após o lançamento da solução no final do segundo trimestre de 2026.
15 de junho de 2026 Remoções da API dos serviços do Google Play Games v1 Um novo SDK dos serviços do Google Play Games v1 com APIs GSI removidas será publicado sem mais correções de bugs ou atualizações dos recursos atuais dos serviços do Google Play Games v1.
Se um título v1 atual for atualizado para a versão mais recente dos serviços do Google Play Games v1, as funcionalidades dos serviços do Google Play Games nessa nova versão vão parar de funcionar.
  1. Os jogos nos serviços do Google Play Games v1 não podem fazer upgrade do SDK v1 para com.google.android.gms:play-services-games:25.0.0, que remove as APIs v1.
  2. Qualquer jogo que não tiver migrado para os serviços do Google Play Games v2 poderá apresentar erros de compilação porque o play-services-auth não oferece mais o GSI a partir de maio de 2026.
  3. Seguindo a linha do tempo mencionada na seção anterior, os jogos podem manter a vigilância sobre o upgrade de outros SDKs e garantir que outros SDKs não estejam usando o novo SDK do Credential Manager até que sejam migrados para os serviços do Google Play Games v2.
Maio de 2027 Encerramento dos serviços do Google Play Games v1 Todo o tráfego dos serviços do Google Play Games v1 bloqueado sem compilação de um jogo.

As APIs dos serviços do Google Play Games v1 atuais param de funcionar no ambiente de produção. 		A única opção é migrar para os serviços do Google Play Games v2 antes desse prazo para evitar interrupções no login e na integração de jogadores.

  • Após setembro de 2025, as APIs e o SDK dos serviços relacionados a jogos v1 serão descontinuados. Os títulos atuais com integrações v1 anteriores vão continuar funcionando. O Google Play impede a publicação de novos títulos que usam o SDK e as APIs v1.

  • A partir de 15 de junho de 2026, as APIs descontinuadas serão removidas do SDK.

  • A partir de junho de 2027, o SDK dos serviços relacionados a jogos v1 será removido. As chamadas para essas APIs vão falhar, mesmo que você esteja usando versões anteriores do SDK.

A tabela a seguir lista as versões dos serviços relacionados a jogos v1 (SDK), as datas de descontinuação e os guias de migração:

Versão do SDK Data de lançamento Guia de migração
play-services-games:v24.0.0 12 de setembro de 2025
Descontinuado		 Migrar para a v2(Java ou Kotlin)
v0.10.15 Unity 17 de setembro de 2025
Descontinuado		 Migrar para a v2(Unity)
play-services-games:v25.0.0 15 de junho de 2026
API dos serviços do Google Play Games v1 removida do SDK.		 Migrar para a v2(Java ou Kotlin)

Exemplo de impacto da remoção da API GSI

Considere um cenário em que um SDK, SDK1, recupera uma lista de amigos da Conta do Google de um jogador. Para usar esse recurso, os jogadores precisam autenticar a Conta do Google usando o SDK de autenticação do Google.

Talvez seja necessário atualizar o SDK de autenticação do Google nestas situações:

  • Resolver um bug crítico no fluxo de autenticação.
  • Implementar novas experiências de chave de acesso oferecidas pelo SDK do Credential Manager.

A tabela a seguir descreve os três cenários para atualizar a integração de autenticação do jogo:

  • Cenário 1:o SDK1 faz upgrade para o SDK de autenticação do Google mais recente.
  • Cenário 2:o SDK1 é integrado ao Gerenciador de credenciais, deixando o SDK de autenticação do Google inalterado.
  • Cenário 3:o SDK1 é integrado ao Credential Manager e remove o SDK de autenticação do Google.
Recurso Cenário 1 Cenário 2 Cenário 3
Cenários de upgrade de autenticação
  1. Sem saber da remoção das APIs GSI, o jogo faz upgrade para o SDK de autenticação mais recente.
  2. A funcionalidade de autenticação atual é interrompida e o SDK1 é forçado a integrar o SDK do Credential Manager.
  3. O jogo lança a versão mais recente com o SDK de autenticação e o SDK do Gerenciador de credenciais mais recentes.
 Consciente da remoção da API GSI, o SDK1 não faz upgrade do SDK de autenticação, mas alimenta a funcionalidade de autenticação do Google usando o SDK do Gerenciador de credenciais na versão mais recente. Na versão mais recente, o SDK1 alimenta a funcionalidade de autenticação do Google usando o SDK do Credential Manager e remove completamente o SDK de autenticação.
SDK dos serviços do Google Play Games v1 Não alterado Não alterado Não alterado
O que acontece quando o jogo é compilado
  1. Os serviços relacionados a jogos do Google Play v1 exigem uma integração separada do SDK de autenticação. Como o SDK de autenticação é atualizado sem APIs GSI, os serviços relacionados a jogos do Google Play v1 serão interrompidos.
  2. O jogo recebe erros de tempo de compilação.
  3. Em seguida, o jogo tenta seguir o caminho de resolução.
 O jogo recebe erros de tempo de compilação Em seguida, o jogo tenta seguir o caminho de resolução.
Possível experiência do jogador N/A. Como o jogo não pode ser compilado, não há publicação.
  1. O jogador vê o seletor de contas dos serviços do Google Play Games ao fazer a autenticação usando os serviços do Google Play Games v1.
  2. O jogador vê a página inferior do Credential Manager ao fazer a autenticação no recurso SDK1.
  1. O jogador vê o seletor de contas dos serviços do Google Play Games ao fazer a autenticação usando os serviços do Google Play Games v1.
  2. O jogador vê a página inferior do Credential Manager ao fazer a autenticação no recurso SDK1.
Caminho de resolução para o desenvolvedor de jogos
  1. Descubra qual SDK está causando o upgrade do SDK de autenticação.
  2. Reverta a versão do SDK1.
  3. Recompile o jogo com o recurso.
  4. Se o novo recurso do jogo exigir um upgrade para o SDK1, fale com o SDK1 para adotar os cenários 2 ou 3 para a versão.
  1. Nada
  2. No entanto, se você também estiver usando um botão Fazer login com o Google, talvez seja necessário usar dois tipos de fluxos de login do Google para jogadores.
  1. Nada
  2. No entanto, se você também estiver usando um botão Fazer login com o Google, talvez seja necessário usar dois tipos de fluxos de login do Google para jogadores.
Resultado final para os serviços do Google Play Games v1 O jogo não precisa fazer upgrade para os serviços do Google Play Games v2, mas o SDK1 permanece desatualizado. O jogo não precisa fazer upgrade dos serviços do Google Play Games v1 para a v2. O jogo não precisa fazer upgrade dos serviços do Google Play Games v1 para a v2.