Pular para o conteúdo principal

Procedimento de migração para a API LoginWithGooglePlayGamesServices

A migração consiste em mudar para LoginWithGooglePlayGamesServices, já que o Google está incentivando os desenvolvedores a migrar para essa forma de autenticação. Após a migração dos jogadores, não haverá dependência da API LoginWithGoogleAccount, e os desenvolvedores poderão atualizar para a versão mais recente do plug-in. Para obter mais informações, confira a documentação oficial do Google.

Etapas de alto nível

  1. Escolha a versão correta do “Play Games Plugin for Unity”.
  2. Inicialize a Play Games Platform e autentique o usuário.
  3. Faça login no PlayFab usando LoginWithGoogleAccount.
  4. Vincule seu perfil do Google Play Games à conta de jogador do PlayFab.
  5. Verifique se o usuário consegue fazer login usando a API LoginWithGooglePlayGamesServices.
  6. (Opcional) Desvincule seu perfil da Conta do Google da conta de jogador do PlayFab.

Etapas de migração

Escolher a versão correta do “Play Games Plugin for Unity”

As versões mais recentes do plug-in não funcionam para a migração, pois o Google não permite mais solicitar escopos extras; portanto, a API LoginWithGoogleAccount do PlayFab não funciona mais. Estas etapas de migração foram testadas e documentadas usando a versão 0.10.14 do “Play Games Plugin for Unity”, que pode ser encontrada aqui: playgameservices/play-games-plugin-for-unity at v10.14 (github.com) Para conhecer as etapas de instalação e configuração do plug-in, consulte o README do plug-in

Inicializar a Play Games Platform e autenticar o jogador

Consulte a seção Configuration & Initialization Play Games Services do README e solicite o escopo “profile” como parte de PlayGamesClientConfiguration.

Fazer login no PlayFab usando LoginWithGoogleAccount

Faça login na conta de um jogador existente usando a API de autenticação LoginWithGoogleAccount. Para fazer login com êxito, você precisa fornecer um Server Auth Token, que pode ser solicitado por meio do método GetServerAuthCode.
Antes de qualquer migração, um usuário vinculado à Conta do Google aparece assim no Game Manager: Migrar para LoginWithGooglePlayGamesServices: etapa 1

Vincular o perfil do Google Play Games do jogador à conta de jogador do PlayFab

Nesta etapa, você vincula a conta do Google Play Games do jogador à conta existente do PlayFab do jogador, que antes estava vinculada apenas à Conta do Google.
Após esta etapa, o jogador deverá ter ambos os perfis de conta associados no lado do PlayFab e poderá começar a usar a API de autenticação LoginWithGooglePlayGamesServices a partir de agora. Se você navegar até o Game Manager, verá ambas as contas associadas ao jogador, conforme mostrado: Migrar para LoginWithGooglePlayGamesServices: etapa 2

Verificar se o jogador consegue fazer login usando a API LoginWithGooglePlayGamesServices

(Opcional) Desvincular seu perfil da Conta do Google da conta de jogador do PlayFab

Esta etapa é opcional. No entanto, se você já confirmou que o perfil do Google Play Games Services está vinculado à conta do jogador e que ele consegue fazer login no PlayFab com êxito, provavelmente desejará desvincular quaisquer perfis anteriores da Conta do Google vinculados ao perfil do jogador usando a API UnlinkGoogleAccount e passar a usar somente a API LoginWithGooglePlayGamesServices.
Após a desvinculação, você deverá ver apenas a identidade do Google Play Games no Game Manager para o jogador: Migrar para LoginWithGooglePlayGamesServices: etapa 3
Última modificação em 6 de outubro de 2026