Vinculação de contas

Use a vinculação de contas para conectar as Contas do Google dos seus usuários a contas de usuário no seu sistema de autenticação. Isso permite criar experiências mais ricas para os usuários. Por exemplo, é possível salvar as preferências de comida ou música do usuário, o histórico de transações e outras informações que podem ser usadas para oferecer uma experiência mais personalizada.

Se a ação for um complemento de apps existentes em diferentes plataformas (por exemplo, na Web ou no Android), você poderá usar a vinculação de conta para disponibilizar com segurança as preferências dos usuários para todas as plataformas, o que garante uma experiência consistente em várias plataformas.

A vinculação de contas para o Actions on Google usa o Login do Google, o sistema de autenticação seguro do Google e, opcionalmente, OAuth 2.0, o protocolo padrão do setor para autorização.

Entenda o fluxo de vinculação de contas

Quando o Google Assistente faz a correspondência de uma Conta do Google com um usuário, você pode usar a vinculação da conta para solicitar a permissão do usuário para acessar essa Conta do Google. Você pode usar os dados da conta para fazer o seguinte:

  • Para encontrar uma correspondência para a conta no seu sistema de autenticação se o usuário já usou a ação ou um dos apps em outras plataformas.
  • Para criar uma nova conta no seu sistema de autenticação para um novo usuário.

O Actions on Google oferece três tipos diferentes de vinculação de contas.

Login do Google

Figura 1: o tipo de vinculação de conta exclusivo do Login do Google é a solução recomendada para ações que segmentam apenas o Google Assistente.

Com o Login do Google para o Assistente, sua ação pode solicitar acesso ao perfil do usuário durante uma conversa, incluindo o nome, o endereço de e-mail e a foto do perfil. O usuário pode concluir todo o fluxo por voz, o que proporciona uma experiência de login mais simples.

Esse tipo de vinculação de conta é recomendado se qualquer uma das seguintes opções se aplicar:

  • Você não tem um sistema de autenticação.
  • Você tem um sistema de autenticação e quer vinculá-lo apenas aos usuários que se inscreveram nos seus aplicativos usando o endereço @gmail.com.

Para saber mais, consulte o Guia de conceitos do Login do Google e o Guia de implementação.

Vinculação "Simplificada" do Login do Google com base em OAuth

Figura 2: a vinculação simplificada é a solução recomendada para ações multiplataforma.

O tipo de vinculação "simplificada" do Login do Google com base em OAuth adiciona o Login do Google à vinculação de conta baseada em OAuth. Isso permite uma vinculação contínua por voz a usuários do Google, além de permitir a vinculação de contas a usuários registrados no seu serviço com uma identidade que não seja do Google.

Para usar esse fluxo, você precisa estender um dos fluxos padrão do OAuth 2.0 compatíveis para adicionar suporte às extensões proprietárias do protocolo do Google, que permitem:

  • Vincule contas de forma simples usando as informações do perfil do Google.
  • Crie novas contas facilmente usando as informações do perfil do Google (opcional).

Esse tipo de vinculação de conta é recomendado se você tiver um sistema de autenticação e quiser permitir que os usuários se conectem a endereços que não são do @gmail.com.

Para saber mais, consulte o Guia de conceito de vinculação "Simplificado" do Login do Google baseado em OAuth e o guia de implementação.

Vinculação do OAuth

O tipo de vinculação do OAuth é compatível com dois fluxos do OAuth 2.0 padrão do setor, os fluxos de código implícito e de autorização.

O uso desse fluxo não é recomendado, porque exige a transferência da interação do usuário de voz para tela. Considere usar esse fluxo se você tiver uma implementação existente de um servidor OAuth 2.0 e não for possível estender o endpoint de troca de token para adicionar suporte para os protocolos do Google para vinculação automática e criação de conta a partir de um token de ID.

Para saber mais, consulte o Guia de conceitos de vinculação do OAuth e o Guia de implementação.

Para mais informações sobre como implementar a vinculação de contas na sua ação, consulte o seguinte recurso: