O Login do Google (GSI) para o Google Assistente oferece a experiência de vinculação mais simples para os usuários e é o fluxo mais fácil de implementar pelos desenvolvedores. Com a GSI, sua Ação pode solicitar acesso ao perfil do Google do usuário durante uma conversa e, se o usuário consentir, receber o nome, o endereço de e-mail e a foto do perfil do usuário. A Ação pode usar essas informações para verificar se o usuário tem uma Conta do Google no sistema. Caso contrário, a Ação perguntará ao usuário se ele quer criar uma nova conta no sistema com base nas informações do perfil do Google.
A GSI é a solução de vinculação de contas recomendada nas seguintes situações:
- Você não tem um sistema de autenticação e/ou espera que todos os usuários tenham uma Conta do Google. Por exemplo, se a Ação for direcionada especificamente ao Google Assistente, todos os usuários terão Contas do Google.
- Você tem um sistema de autenticação e quer vincular apenas os usuários que fizeram login no sistema usando as Contas do Google deles.
Para verificar se a GSI é a solução certa para você, consulte a página Escolher o tipo de vinculação da conta.
Termos-chave
Antes de ler sobre como a GSI funciona, conheça estes termos:
Token de ID do Google:uma declaração assinada da identidade de um usuário que contém as informações básicas do perfil dele no Google (nome, endereço de e-mail e foto do perfil). Um token de ID do Google é um JSON Web Token (JWT).
Confira a seguir um exemplo de token decodificado:
{ "sub": 1234567890, // The unique ID of the user's Google Account "iss": "https://accounts.google.com", // The token's issuer "aud": "123-abc.apps.googleusercontent.com", // Client ID assigned to your Actions project "iat": 233366400, // Unix timestamp of the token's creation time "exp": 233370000, // Unix timestamp of the token's expiration time "name": "Jan Jansen", "given_name": "Jan", "family_name": "Jansen", "email": "jan@gmail.com", // If present, the user's email address "locale": "en_US" }
user.verificationStatus
:uma propriedade definida pelo sistema para indicar se a sessão atual tem um usuário verificado.user.accountLinkingStatus
:propriedade definida pelo sistema para indicar se o usuário na sessão atual tem uma identidade vinculada.Cena do sistema de vinculação de contas:um cenário predefinido que implementa o fluxo de confirmação para vinculação de contas e pode ser personalizado para atender a casos de uso específicos.
Como funciona
O fluxo fundamental da GSI é o seguinte:
- Sua Ação pede consentimento ao usuário para acessar o perfil do Google.
- Depois que o usuário dá o consentimento, sua Ação recebe um token de ID do Google que contém as informações do perfil do Google do usuário.
- Valide e decodifique o token para ler o conteúdo do perfil. Se você usar a biblioteca de fulfillment do Actions on Google para Node.js, ela vai validar e decodificar o token.
A Ação usa esse token para verificar se as informações do perfil do Google do usuário existem no sistema.
- Em caso afirmativo, isso significa que o usuário já fez login no seu sistema com a Conta do Google. O usuário pode continuar a conversa com o Google Assistente com a identidade vinculada à Conta do Google.
Caso contrário, o usuário pode criar uma nova conta no sistema com as informações contidas no token de ID do Google. O usuário pode continuar a conversa com o Google Assistente com a nova conta vinculada.
Fluxos de Login do Google
Esta seção descreve os vários fluxos que podem ocorrer com o Login do Google.
Fluxo 1: há informações do usuário no seu sistema
O diagrama a seguir mostra o fluxo completo que ocorre com a GSI quando as informações do usuário já existem no seu sistema:
Nesse caso, você faz a transição para a cena do sistema de vinculação de contas e fornece uma lógica personalizada. Essa cena pede permissão ao usuário para acessar as informações do perfil do Google.
Depois que o usuário consente, o Google Assistente envia uma solicitação com as
informações do perfil de user@gmail.com
. Nesse caso, as informações
contidas no token de ID do Google para user@gmail.com
correspondem a uma conta no
seu sistema. Portanto, a identidade do usuário na ação é vinculada automaticamente
a essa conta. Seu webhook pode ler a ordem habitual do usuário em um banco de dados e responder de acordo.
Fluxo 2: as informações do usuário não existem no seu sistema
O diagrama a seguir mostra o fluxo completo que ocorre com a GSI quando as informações do usuário não existem no seu sistema:
Nesse caso, as informações contidas no token de ID do Google para
user@gmail.com
não correspondem a uma conta no seu sistema. Por isso, o Google Assistente
pergunta ao usuário se ele quer criar uma nova conta. O usuário pode concluir
o processo de criação de conta por comando de voz, em vez de transferir para
um dispositivo filtrado.
Quando o usuário concorda em criar uma conta, seu serviço usa as informações no token de ID (nome e endereço de e-mail do usuário) para criar uma conta para ele. Depois que a conta é criada, a identidade do usuário na sua Ação é vinculada à nova Conta do Google.
Nesse caso, o usuário não tem um pedido normal porque ele é novo no serviço. Portanto, sua ação pergunta o que ele quer pedir. Também é possível perguntar ao usuário se ele quer definir o pedido mais recente como a ordem de sempre.