Login e saída automáticos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, descrevemos como implementar recursos relacionados à forma como os usuários fazem login ou sair com o Google One Tap.

Fazer login de usuários automaticamente

O Google One Tap oferece suporte ao login automático, que proporciona uma experiência do usuário (UX) mais fácil ao remover as etapas manuais que os visitantes precisam seguir ao retornar ao site. Os usuários não precisam se lembrar da Conta do Google selecionada durante a última visita, reduzindo as chances de criação de contas duplicadas desnecessárias na plataforma.

O objetivo do login automático é complementar o botão "Fazer login com o Google" e as caixas de diálogo de um toque. Ela foi projetada para ser usada em todo o site, com inscrição manual ou troca de contas que ocorrem somente depois que o usuário sai do site pela primeira vez.

Para que o login automático ocorra, as seguintes condições são necessárias:

  • o usuário precisa primeiro fazer login na Conta do Google e
  • Você autorizou o compartilhamento do perfil da conta com seu app.

Para páginas em que o login automático está ativado e se essas condições forem atendidas, a credencial do token de ID dos visitantes será retornada automaticamente sem qualquer interação do usuário. Se essas condições não forem atendidas e, mesmo que o login automático esteja ativado na página, o usuário usará o fluxo de toque único para login ou consentimento por padrão. Se um usuário tiver várias Contas do Google e acessar seu site, primeiro ele precisará fazer login em uma única Conta do Google e fornecer o consentimento dela.

Meça a taxa de sucesso do login automático usando o valor auto no campo select_by do objeto de credencial retornado.

Para ativar o login automático, adicione data-auto_select="true" ao seu código, conforme mostrado no snippet a seguir:

<div id="g_id_onload"
     data-client_id="YOUR_GOOGLE_CLIENT_ID"
     data-auto_select="true"
     data-login_uri="https://your.domain/your_login_endpoint">
</div>

Sair

Quando um usuário sai do seu site, ele pode ser direcionado para uma página em que uma solicitação de toque do Google One é exibida automaticamente. Para essa configuração, a seleção automática precisa ser proibida. Caso contrário, o usuário será conectado automaticamente de novo, o que leva a uma UX de loop inativo.

Para proibir a seleção automática após um usuário sair, adicione o nome da classe g_id_signout a todos os seus links e botões de saída. Veja o snippet de código a seguir:

<div class="g_id_signout">Sign Out</div>

O snippet de código JavaScript a seguir também pode ser usado para sair:

  const button = document.getElementById(‘signout_button’);
    button.onclick = () => {
      google.accounts.id.disableAutoSelect();
    }

Consequentemente, o status de usuário desconectado é gravado por meio de um cookie no seu domínio, para que a UX do loop inativo seja evitada.

O status de logout é armazenado no cookie g_state no seu domínio. Se você tiver um serviço que monitora todos os cookies usados no seu domínio, será necessário notificá-los sobre isso.

Se você não quiser carregar a biblioteca de cliente nas páginas pós-login, use algumas soluções simples como abaixo para evitar a UX de loop inativo no momento de saída.

  • Ao sair, redirecione os usuários para uma página (por exemplo, https://example.com/logged_out), em que um toque não é exibido ou o login automático está sempre desativado.
  • Ao sair, adicione um parâmetro ao URL. Por exemplo, logged_out=1. Ao renderizar a API One Tap by JavaScript, verifique esse parâmetro de URL e desative o login automático quando presente.