Guia conceitual do Login do Google

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.

Observação: o usuário é a) identificado por reconhecimento de voz ou b) configurado no dispositivo. Se a voz do usuário for verificada, mas não reconhecida, ele será considerado um convidado.

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": "[e-mail]", // 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:

1. Sua Ação pede consentimento ao usuário para acessar o perfil do Google.
2. 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.
3. 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.

4. A Ação usa esse token para verificar se as informações do perfil do Google do usuário existem no sistema.

   1. 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.

   2. 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.

      Observação :normalmente, as novas contas não têm uma senha definida. Recomendamos que você adicione o Login do Google em outras plataformas para permitir que os usuários façam login pelo Google em todas as plataformas do seu aplicativo. Outra opção é enviar por e-mail ao usuário um link que inicie o fluxo de recuperação de senha para que ele possa definir uma senha para fazer login em outras plataformas.

Fluxos de Login do Google

Esta seção descreve os vários fluxos que podem ocorrer com o Login do Google.

Observação: os fluxos a seguir pressupõem que o usuário consente que a Ação acesse as informações do perfil do Google. Se um usuário não der consentimento, forneça a ele uma maneira de continuar a ação com um fluxo alternativo e limitado. Para mais informações, consulte Práticas recomendadas.

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:

Observação :uma linha de Webhook para User representa uma resposta simples que você cria e personaliza. As linhas mostradas do Assistente para o Usuário representam solicitações que pertencem ao Google Assistente e têm opções limitadas de personalização. As solicitações que exigem permissão sempre são de propriedade do Assistente. Do ponto de vista do usuário, o Google Assistente envia os dois tipos de resposta.

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 [e-mail]. Nesse caso, as informações contidas no token de ID do Google para [e-mail] 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 [e-mail] 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.