Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página descreve como implementar recursos relacionados à forma como os usuários fazem login ou
saída com o Google One Tap.
Fazer login de usuários automaticamente
O Google One Tap oferece suporte ao login automático, que oferece uma experiência do usuário (UX) sem complicações, removendo as etapas manuais que os usuários precisam realizar ao retornar
ao seu site. Os usuários não precisam se lembrar de qual Conta do Google eles selecionaram
na última visita, diminuindo as chances de contas duplicadas desnecessárias
serem criadas na sua plataforma.
O login automático complementa o botão "Fazer login com o Google"
e as caixas de diálogo do One Tap. Ele foi projetado para ser usado em todo o site, com
inscrição manual ou troca de contas ocorrendo somente depois que o usuário tiver
saída do site.
Para que o login automático ocorra, as seguintes condições são necessárias:
Os usuários precisam fazer login na Conta do Google.
já tenha concedido consentimento para compartilhar o perfil da conta com seu app;
ao usar o FedCM, fez apenas uma tentativa de login nos últimos 10 minutos.
O recurso "Um toque" é exibido quando ocorrem tentativas de login repetidas durante esse período.
Ao usar a FedCM, o Chrome exige que os usuários confirmem novamente que querem
fazer login no site com a Conta do Google em cada instância do Chrome, mesmo que o
usuário tenha aprovado o site antes do lançamento da FedCM. Essa mudança pode afetar
a taxa de conversão no seu site atual que usa o recurso Um toque. Na atualização M121 do Chrome,
o melhoramento do login automático mitiga o problema de queda da taxa de conversão.
Nas páginas em que o login automático está ativado e se essas condições forem atendidas,
a credencial do token de ID do usuário será retornada automaticamente sem nenhuma 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 vai usar o fluxo de um toque para fazer login ou
consentimento. Se um usuário tiver várias Contas do Google e visitar seu site, ele
precisará fazer login em uma única Conta do Google e fornecer
o consentimento para essa conta.
É possível medir a taxa de sucesso de 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 código, conforme
mostrado no snippet abaixo:
Quando um usuário sai do seu site, ele pode ser direcionado a uma página em que uma
solicitações do Google One Tap é exibida automaticamente. Para essa configuração, a seleção automática
precisa ser proibida. Caso contrário, o usuário será conectado automaticamente novamente, o que
leva a uma UX de loop morto.
Como usar a FedCM
Para melhorar a experiência do usuário, há um período de 10 minutos entre cada
tentativa de login automático. Durante esse período, o comando "Um toque" é
exibido. Os usuários precisam clicar explicitamente em "Um toque" para fazer login.
Sem FedCM
Para proibir a seleção automática depois que um usuário sai, adicione o nome da classe
g_id_signout a todos os links e botões de logout. Confira 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:
Para evitar uma UX de loop morto, o status de desconectado do usuário é armazenado em um cookie chamado
g_state, definido pela biblioteca de serviços de identidade do Google. Por padrão, o
domínio do cookie é definido como o domínio da página atual. Se o recurso Um toque for exibido
no domínio pai e nos subdomínios, o cookie de estado precisa estar visível em
todos os domínios. Use o atributo data-state_cookie_domain para definir o
domínio do cookie g_state como seu domínio pai. Por exemplo, adicione
data-state_cookie_domain="example.com" ao elemento g_id_onload para um
domínio pai de example.com e um subdomínio chamado webapp.example.com.
Se você tiver um serviço que monitora todos os cookies usados no seu domínio,
é necessário notificar o serviço sobre o cookie g_state.
Se você não quiser carregar a biblioteca de cliente nas páginas após o login, use
estas soluções para evitar uma UX de loop morto após o deslogoff:
Ao sair, redirecione os usuários para uma página (por exemplo,
https://example.com/logged_out), em que o recurso de um toque não aparece ou
em que o login automático está sempre desativado.
Ao sair, adicione um parâmetro ao URL. Por exemplo, logged_out=1.
Ao renderizar o recurso "Um toque" pela API JavaScript, verifique esse parâmetro de URL e
desative o login automático quando ele estiver presente.
Principais jornadas do usuário
A página de login automático.
Como usar a FedCM
Os usuários podem fechar a solicitação de um toque clicando no botão X. Para
considerações de acessibilidade, um token de ID é compartilhado com seu site
mesmo que os usuários cliquem no botão X.
Para melhorar a experiência do usuário, há um período de 10 minutos entre cada
tentativa de login automático. Durante esse período, o comando "Um toque" é
exibido. Os usuários precisam clicar explicitamente em "Um toque" para fazer login.
Sem FedCM
Se os usuários não clicarem no botão Cancelar em até 5 segundos, um token de ID será compartilhado com seu site.
Quando o login é cancelado, com base no número de sessões ativas do Google,
a página de seleção de conta ou a página de usuário recorrente é exibida.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-05-23 UTC."],[[["\u003cp\u003eGoogle One Tap enables automatic sign-in, providing a frictionless user experience by eliminating manual login steps for returning users.\u003c/p\u003e\n"],["\u003cp\u003eAutomatic sign-in works when users are signed in to their Google Account, have previously granted consent, and (for FedCM) haven't attempted sign-in within the last 10 minutes.\u003c/p\u003e\n"],["\u003cp\u003eTo enable automatic sign-in, add \u003ccode\u003edata-auto_select="true"\u003c/code\u003e to your One Tap implementation code.\u003c/p\u003e\n"],["\u003cp\u003eWhen implementing sign-out functionality, ensure auto-selection is disabled to prevent a login loop, which can be achieved by using the \u003ccode\u003eg_id_signout\u003c/code\u003e class or \u003ccode\u003egoogle.accounts.id.disableAutoSelect()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOne Tap sign-out (disabling automatic sign-in) is temporary and does not sign users out of your website or Google services.\u003c/p\u003e\n"]]],[],null,["# Automatic sign-in and sign-out\n\nThis page describes how to implement features related to how users sign in or\nsign out with Google One Tap.\n\nSign in users automatically\n---------------------------\n\nGoogle One Tap supports automatic sign-in, which provides a frictionless user\nexperience (UX) by removing the manual steps users must take when returning\nto your site. Users don't need to remember which Google Account they selected\nduring their last visit, decreasing the chances of unnecessary duplicate\naccounts being created on your platform.\n\nAutomatic sign-in is intended to complement our Sign in with Google button\nand One Tap dialogs. It is designed to be used across your entire site, with\nmanual sign-up or switching accounts occurring only after the user has first\nsigned-out of your site.\n\nFor Automatic sign-in to occur the following conditions are required:\n\n- users must first be signed-in to their Google Account, and\n- previously granted consent to share their account profile with your app, and\n- when using FedCM, made only a single sign-in attempt in the last 10 minutes. One Tap is displayed when repeated sign-in attempts occur during this window.\n- when using FedCM, Chrome requires users to reconfirm that they want to sign in to the website with Google Account in each Chrome instance even if the user approved the website prior to the FedCM rollout. This change may affect conversion rate on your existing site using One Tap. In Chrome M121 update, [Auto Sign-in improvement](/identity/gsi/web/reference/release-notes#2023-12-21) mitigates conversion rate drop issue.\n\nFor pages where Automatic sign-in is enabled and if these conditions are met\nthe user's ID token credential is automatically returned without any user\ninteraction. If these conditions are not met, and even if Automatic sign-in is\nenabled on the page, the user defaults to the One Tap flow for sign-in or\nconsent. If a user has multiple Google Accounts and visits your site they are\nrequired to first sign-in to a single Google Account and to have provided\nconsent for that account.\n\nYou may measure Automatic sign-in success rate using the `auto` value in the\n[select_by](/identity/gsi/web/reference/js-reference#select_by) field of the returned credential object.\n\nTo enable automatic sign-in, add `data-auto_select=\"true\"` to your code, as\nshown in the following snippet: \n\n \u003cdiv id=\"g_id_onload\"\n data-client_id=\"\u003cvar translate=\"no\"\u003eYOUR_GOOGLE_CLIENT_ID\u003c/var\u003e\"\n data-login_uri=\"\u003cvar translate=\"no\"\u003ehttps://your.domain/your_login_endpoint\u003c/var\u003e\"\n data-auto_select=\"true\"\u003e\n \u003c/div\u003e\n\n| **Note:** The [upgraded One Tap UX for ITP browsers](/identity/gsi/web/guides/features#upgraded_ux_on_itp_browsers) doesn't support auto sign-in.\n\nSign out\n--------\n\nWhen a user signs out of your website, they can be directed to a page where a\nGoogle One Tap prompt is automatically displayed. For this setup, auto-selection\nmust be prohibited. Otherwise, the user is automatically signed in again, which\nleads to a dead-loop UX. \n\n### Using FedCM\n\nTo improve user experience, there is a 10 minute quiet period between every\nautomatic sign-in attempt. During this time period, One Tap prompt is\ndisplayed instead. Users need to explicitly click One Tap to sign in.\n\n### Without FedCM\n\nTo prohibit auto-selection after a user signs out, add the class name\n`g_id_signout` to all of your logout links and buttons. See the following code\nsnippet: \n\n \u003cdiv class=\"g_id_signout\"\u003eSign Out\u003c/div\u003e\n\nThe following JavaScript code snippet can also be used for sign out: \n\n const button = document.getElementById('signout_button');\n button.onclick = () =\u003e {\n google.accounts.id.disableAutoSelect();\n }\n\nTo prevent a dead-loop UX, user signed-out status is stored in a cookie named\n`g_state` that is set by the Google Identity Services library. By default the\ncookie domain is set to the domain of current page. If One Tap is displayed\non the parent domain and subdomains, the state cookie must be visible across\nall of your domains. Use the `data-state_cookie_domain` attribute to set the\n`g_state` cookie domain to your parent domain. For example, add\n`data-state_cookie_domain=\"example.com\"` to the `g_id_onload` element for a\nparent domain of `example.com` and a subdomain named `webapp.example.com`.\n| **Key Point:** If One Tap is displayed on multiple domains, you need to set the `g_state` cookie domain to your parent domain.\n\nIf you have a service that monitors all of the cookies used in your domain,\nyou need to notify them of the `g_state` cookie.\n| **Key Point:** Feel free to use other ways to prevent the dead-loop UX on log out moment.\n\nIf you don't want to load the client library on your post-login pages, use\nthese solutions to prevent a dead-loop UX after log out occurs:\n\n- On log out, redirect users to a page (say, `https://example.com/logged_out`) where One Tap is not displayed, or where auto sign-in is always disabled.\n- On log out, add a parameter to the URL. For example, `logged_out=1`. When rendering One Tap by JavaScript API, check that URL parameter and disable auto sign-in when present.\n\n| **Warning:** The term 'sign out' here refers to temporarily disabling One Tap Automatic sign-in for one day. This API does not sign out your users out of your website or any Google websites.\n\nKey user journeys\n-----------------\n\nThe automatic sign-in page. \n\n### Using FedCM\n\nUsers can close the One Tap prompt by clicking the **X** button. For\naccessibility consideration, an ID token is shared with your website\neven if users click the **X** button.\n\nTo improve user experience, there is a 10 minute quiet period between every\nautomatic sign-in attempt. During this time period, One Tap prompt is\ndisplayed instead. Users need to explicitly click One Tap to sign in.\n\n### Without FedCM\n\nIf users don't click the **Cancel** button within 5 seconds, an ID token\nis shared with your website.\n\nWhen Sign-In is cancelled, based on the number of active Google sessions,\neither the account chooser page or the returning user page displays.\n\n- Multiple Google sessions\n\n- Single Google Sessions\n\n| **Key Point:** Once cancelled, Automatic sign-in is disabled for one day."]]
