Guia do conceito de Login do Google (Dialogflow)

O Login do Google (GSI) para o Google Assistente possibilita a vinculação mais integrada experiência dos usuários e é o fluxo mais fácil para os desenvolvedores implementarem. 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, endereço de e-mail e foto do perfil. Sua Ação pode usar essas informações para verificar se o o usuário tem uma Conta do Google no seu sistema. Caso contrário, a ação perguntará ao usuário se ele quer criar uma nova conta no seu sistema com base informações de perfil.

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

A GSI é a solução recomendada de vinculação de contas se alguma das seguintes condições se aplicar:

• Você não tem um sistema de autenticação e/ou espera que todas as que os usuários tenham uma Conta do Google. Por exemplo, se a ação for especificamente você espera que todos os usuários tenham acesso ao Google Assistente contas de serviço.
• Você já tem um sistema de autenticação e quer vincular apenas usuários que fez login no seu sistema usando as Contas do Google dele.

Para verificar se a GSI é a solução certa para você, consulte o página Escolha o tipo de vinculação da conta.

Termos-chave

Antes de ler sobre como a GSI funciona, familiarize-se com os seguintes termos:

• Token de ID do Google: uma declaração assinada da identidade de um usuário que contém informações básicas do perfil do Google de um usuário (nome, endereço de e-mail e foto do perfil). Um token de ID do Google é um JSON Web Token (JWT).

  Este é 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"
}

• Intent de ajuda de login da conta:uma intent auxiliar que você chama solicitar um fluxo de vinculação de contas no Google Assistente. Para mais informações, consulte Login da conta.
  • String de contexto:uma string personalizada que você adiciona à conta intent de ajuda de login que informa ao usuário por que você precisa que ele faça a vinculação a conta.

Como funciona

O fluxo fundamental da GSI é o seguinte:

1. Sua Ação pede ao usuário consentimento para acessar o perfil do Google dele.
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 o método biblioteca de cliente do Actions on Google para Node.js ou Java ele valida e decodifica o token para você.

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

   1. Em caso afirmativo, isso significa que o usuário já fez login no sistema com a Conta do Google. O usuário pode continuar a conversa com o ao Google Assistente, com a identidade vinculada à Conta do Google.

   2. Se não tiver, o usuário pode criar uma nova conta em seu sistema com as informações contidas no token de ID do Google. O usuário pode então continuar a conversa com o Assistente com a nova conta vinculada.

      Observação :normalmente, novas contas não têm uma senha definida. É recomendamos adicionar o Login do Google a outras plataformas para ativar que os usuários façam login pelo Google em todas as plataformas do seu aplicativo. Se preferir, envie um e-mail para o usuário com um link que inicie sua senha fluxo de recuperação para permitir que o usuário defina 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 presumem que o usuário consentiu na ação acessar as informações do perfil do Google. Se um usuário não der consentimento, ofereça a eles uma maneira de continuar a ação com um fluxo alternativo limitado. Para mais informações, consulte Práticas recomendadas.

Fluxo 1: as informações do usuário existem no seu sistema

O diagrama a seguir mostra o fluxo completo que ocorre com a GSI quando os informações do usuário já existem no seu sistema:

Observação :uma linha de Webhook para User representa um resposta simples que você cria e personalizar. As linhas desenhadas do Assistente até o Usuário representam comandos que estão são do Assistente e têm opções limitadas de personalização (solicitações que exigem permissão são sempre do Google Assistente). Do conjunto de dados os dois tipos de resposta são enviados pelo Google Assistente.

Nesse caso, você chama a intent auxiliar actions.intent.SIGN_IN com uma string de contexto personalizada por você. Essa intent pede permissão ao usuário para acessar as informações do perfil do Google.

Após o consentimento do usuário, o Assistente envia uma solicitação com as seguintes informações: informações de perfil de [e-mail]. Nesse caso, as informações no token de ID do Google para [e-mail] corresponde a uma conta em seu sistema, para que a identidade do usuário na sua ação seja vinculada automaticamente para essa conta. Seu webhook pode ler o pedido normal 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 ao as informações do usuário não existem no seu sistema:

Nesse caso, as informações contidas no token de ID do Google do [e-mail] não corresponde a uma conta no seu sistema. Por isso, o Google Assistente perguntará ao usuário se ele gostaria de criar uma nova conta. O usuário pode concluir o processo de criação de conta por 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 (o nome do usuário e o endereço de e-mail) para criar uma conta para o usuário. Depois que a conta é criada, a identidade do usuário na sua ação está vinculado à nova Conta do Google.

Nesse caso, o usuário não tem um pedido normal porque é novo no o serviço, então a ação pergunta o que eles querem pedir. Você também pode perguntar ao usuário se ele gostaria de definir o pedido mais recente como de costume.