O Login do Google (GSI) para o 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" }
- Intent auxiliar de login da conta:uma intent auxiliar que você chama para
solicitar um fluxo de vinculação de conta do Google Assistente. Para mais informações,
consulte Login na conta.
- String de contexto:uma string personalizada que você adiciona à intent auxiliar de login na conta que informa ao usuário por que você precisa que ele vincule a conta.
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ê usa a biblioteca de cliente do Actions on Google para Node.js ou Java, ela valida e decodifica o token para você.
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ê chama a intent auxiliar actions.intent.SIGN_IN
com uma
string de contexto personalizada. Essa intent solicita permissão ao usuário para
acessar as informações do perfil do Google.
Depois que o usuário consente, o Assistente envia uma solicitação com as
informações de 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.