Programação da descontinuação

Este documento lista o cronograma 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 desligamento planejado, vamos descontinuar o SDK e as APIs da v1 dos serviços do Google Play Games. Migre seu jogo para o SDK dos serviços do Google Play Games v2 para ter acesso aos recursos mais recentes.

Confira os cronogramas de suspensão de uso:

Data Marco de descontinuação
 Impacto Ação do desenvolvedor
3º trimestre 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 pela API v1 dos serviços do Google Play Games, esses recursos continuarão funcionando.

Se o jogo usa um SDK de terceiros ou um SDK do Google que não seja a v1 dos serviços do Google Play Games e que exija uma atualização 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 a v2 dos serviços do Google Play Games de acordo com o caminho da solução mencionado aqui logo após o lançamento da solução no final do segundo trimestre de 2026.
Junho de 2026 Remoções da API v1 dos serviços do Google Play Games Um novo SDK v1 dos serviços do Google Play Games com APIs GSI removidas será publicado sem mais correções de bugs ou atualizações dos recursos v1 atuais dos serviços do Google Play Games.
Se um título da v1 fizer upgrade 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 a v2 dos serviços do Google Play Games poderá apresentar erros de compilação porque o play-services-auth não vai mais fornecer GSI a partir de maio de 2026.
  3. Seguindo o cronograma mencionado na seção anterior, os jogos podem manter a vigilância sobre a atualização de outros SDKs e garantir que outros SDKs não usem o novo SDK do Credential Manager até que sejam migrados para os serviços do Google Play Games v2.
Maio de 2027 Desativação dos serviços do Google Play Games v1 Todo o tráfego dos serviços do Google Play Games v1 é bloqueado sem a compilação de um jogo.

As APIs v1 dos Serviços do Google Play Games 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 anteriores da v1 continuam funcionando. O Google Play impede a publicação de novos títulos que usam o SDK e as APIs da 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 do SDK do games v1, as datas de suspensão de uso 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
A API v1 dos serviços do Google Play Games foi removida do SDK.		 Migrar para a v2(Java ou Kotlin)

Exemplo do impacto da remoção da API GSI

Considere um cenário em que um SDK, o 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 nas seguintes situações:

  • Resolva um bug crítico no fluxo de autenticação.
  • Implemente novas experiências de chaves 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 seu jogo:

  • Cenário 1:o SDK1 é atualizado para a versão mais recente do SDK de autenticação do Google.
  • Cenário 2:o SDK1 se integra ao Gerenciador de credenciais, deixando o SDK de autenticação do Google inalterado.
  • Cenário 3:o SDK1 se integra 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. Não está ciente da remoção das APIs GSI, upgrades de jogos 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 Credential Manager mais recentes.
 Ciente da remoção da API GSI, o SDK1 não faz upgrade do SDK de autenticação, mas usa a funcionalidade de autenticação do Google com o SDK do Credential Manager 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 vão falhar.
  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 a v1 desses serviços.
  2. O jogador vê a página inferior do Gerenciador de credenciais ao se autenticar no recurso do SDK1.
  1. O jogador vê o seletor de contas dos serviços do Google Play Games ao fazer a autenticação usando a v1 desses serviços.
  2. O jogador vê a página inferior do Gerenciador de credenciais ao se autenticar no recurso do SDK1.
Caminho de resolução para desenvolvedores 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, converse com o SDK1 para adotar os cenários 2 ou 3 na versão dele.
  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 a v2 dos serviços do Google Play Games, mas o SDK1 continua desatualizado. O jogo não precisa fazer upgrade dos serviços do Google Play Games v1 para v2. O jogo não precisa fazer upgrade dos serviços do Google Play Games v1 para v2.