Recursos do Fazer login com o Google

Confira abaixo os principais recursos desse recurso. Use o gerador de código para gerar código e incorporar o botão "Fazer login com o Google", o login com um toque e o botão "Fazer login com o Google" nas suas páginas da Web.

Os usuários podem desativar globalmente o login de terceiros em navegadores compatíveis com o FedCM. Quando os usuários desativam o serviço, o recurso de um toque e o login automático ficam indisponíveis e não são mostrados.

um toque

Quando os usuários acessam seu site, se houver uma sessão ativa do Google no navegador, o recurso "Fazer login com o Google" poderá solicitar que eles façam login ou se inscrevam no site usando a Conta do Google deles. Com apenas um toque (para um único caso de sessão do Google) ou dois toques (quando há várias sessões do Google), os usuários podem concluir o fluxo de login ou inscrição federado. A UX com um toque permite pontos de entrada do usuário simples, já que todos os fluxos de UX são realizados em um iframe incorporado nas suas páginas da Web.

Os usuários podem desativar globalmente o recurso "Um toque". Nesse caso, a Conta do Google não exibe o recurso "um toque". Se todas as Contas do Google ativas forem desativadas, a interface de um toque não será mostrada.

Observação: devido à Prevenção de Rastreamento Inteligente (ITP, na sigla em inglês), uma outra página de boas-vindas é exibida para navegadores ITP, como o Chrome no iOS, Safari e FireFox. Os desenvolvedores podem desativar esse recurso em um ou vários navegadores ITP. Mais detalhes em Suporte a um toque em navegadores com ITP.

Importante: consulte Entender a experiência do usuário com um toque para mais detalhes sobre a UX com um toque.

Recomendamos colocar um toque na caixa de diálogo de login principal e nas páginas de detalhes. Os desenvolvedores preferem o recurso por vários motivos:

• de aumento nas taxas de conversão do usuário. Confira nossos estudos de caso sobre como alguns dos nossos parceiros usaram o recurso de um toque para melhorar as experiências de inscrição e login.
• permite o login e a inscrição sem redirecionar os usuários a uma página dedicada de login e inscrição.
• permite que os usuários façam login e se inscrevam no contexto do seu site sem precisar sair da jornada atual.
• mitigar contas duplicadas com solicitações personalizadas e login automático nas visitas de retorno.

Aviso: a interface de um toque deve ser mostrada automaticamente no carregamento da página ou em outros eventos de janela, em vez de ser acionada por um gesto do usuário. Caso contrário, você pode ter uma UX corrompida. Talvez os usuários não vejam a interface após um gesto devido à desativação global, ao resfriamento ou à ausência de sessão do Google.

Login automático

Com um toque, você também pode ativar o login automático cancelável, o que ativa uma UX simplificada para usuários recorrentes. Nenhum gesto do usuário é necessário para que eles façam login automaticamente no seu site. O login automático é acionado quando há apenas uma Conta do Google ativa que já deu consentimento para compartilhar o perfil dela com seu app.

Os usuários podem cancelar o processo de login automático por um curto período, garantindo controle e transparência ao usuário. Se o usuário cancelar o login automático, o recurso "Fazer login com o Google" vai se lembrar da decisão um dia antes de ativar o login automático novamente. O recurso cancelável permite que os usuários tenham mais controle sobre o processo de login automático.

Quando o FedCM está ativado, há um período de espera de 10 minutos entre os eventos de login automático. Se o login automático for acionado durante esse período, os usuários seguirão o fluxo de login com um toque em vez do fluxo automático.

O recurso "Fazer login com o Google para Web" não tem suporte para login silencioso. Nesse caso, uma credencial é retornada sem nenhuma interface exibida. Quando uma credencial de login é retornada do Google para a parte confiável, os usuários finais sempre veem alguma interface, login manual ou automático. Isso melhora a privacidade e o controle do usuário.

Ativar o login automático é uma decisão que você precisa tomar com base na UX do seu site.

Observação: o login automático só pode ser ativado no fluxo com um toque, não no fluxo do botão "Fazer login com o Google".

Importante: consulte Login e saída automáticos para mais detalhes.

Botão "Fazer login com o Google"

Ao contrário do recurso de um toque, o fluxo do botão "Fazer login com o Google" precisa ser acionado por um gesto do usuário. Por isso, o recurso "Fazer login com o Google" fornece apenas a API para renderizar um botão, não a API para iniciar o fluxo de botões de maneira programática. Como desenvolvedor, tudo o que você precisa fazer é renderizar o botão "Fazer login com o Google" nas suas páginas da Web. Quando acionar o fluxo de UX do botão é processado pela biblioteca de forma transparente.

Em outras palavras, o botão "Fazer login com o Google" precisa ser gerado pela biblioteca JavaScript dos Serviços de Identificação do Google. A API de renderização de botões permite personalizar a cor, a forma, o texto e o tamanho para atender aos requisitos de marca do seu site, sem deixar de seguir as diretrizes do Google. Com botões consistentes em todos os sites, os usuários reconhecem, confiam e usam esses botões rapidamente.

Observação: o recurso "Fazer login com o Google" não oferece uma API para iniciar o fluxo de botões de forma programática.

Aviso:não é possível usar seu próprio botão, porque não há uma API para iniciar o fluxo do botão quando ele for clicado.

As informações de perfil do usuário também podem ser usadas para renderizar o botão. Um botão personalizado é exibido apenas quando há pelo menos uma sessão ativa do Google que já autenticou um usuário no seu site antes. Um botão personalizado lembra os usuários finais de que eles já usaram o recurso "Fazer login com o Google" e ajuda a evitar a criação desnecessária de contas duplicadas no seu site. Isso é especialmente útil para usuários finais que acessam seu site apenas de vez em quando. Ele pode esquecer os métodos de login usados.

Importante: consulte Entender o botão personalizado para mais detalhes sobre ele.

O fluxo do botão "Fazer login com o Google" tem suporte aos modos de UX pop-up e de redirecionamento.

• Na UX pop-up, quando o botão "Fazer login com o Google" é clicado, uma nova janela pop-up é aberta na parte superior da página da Web. O fluxo de UX do botão é renderizado em uma janela pop-up.
• Na UX de redirecionamento, o redirecionamento de página inteira acontece depois que o botão "Fazer login com o Google" é clicado. O fluxo de UX do botão é renderizado na mesma janela. No entanto, os usuários não poderão mais ver a página da Web quando a UX do botão for exibida.

Revogar consentimento do usuário

O consentimento do usuário para compartilhar um token de ID pode ser revogado. O "Fazer login com o Google" oferece uma API para revogar o consentimento do usuário de forma programática.

Ao contrário do método revoke() na API de autorização dos Serviços de Identificação do Google, não é necessário ter um token de acesso para revogar o consentimento do usuário. No entanto, é necessário fornecer o endereço de e-mail ou o ID do usuário do Google da sessão de destino do Google, e deve haver uma sessão do Google ativa para essa conta no navegador.

A API de revogação revoga o compartilhamento do token de ID e quaisquer outros escopos de autorização, caso concedidos anteriormente. Isso sempre acontece, independentemente da API de revogação que você usar.

Importante :a API de revogação não mostra nenhuma interface. Consulte Como revogar o consentimento do usuário para mais detalhes.

Gerador de código

O gerador de código é uma ferramenta para desenvolvedores que pode ajudar a gerar o código de integração do lado do cliente. Com a API HTML do recurso Fazer login com o Google, é possível que você não precise de nenhum código JavaScript para a integração do lado do cliente.

Para desenvolvedores que optam por usar a API JavaScript, recomendamos o uso do gerador de código para criar botões de maneira interativa. Também é possível gerar o código HTML primeiro e depois copiá-lo nos campos correspondentes na API JavaScript.

Importante: use o gerador de código para gerar o código de integração do lado do cliente.