As ações de conversa serão descontinuadas em 13 de junho de 2023. Para mais informações, consulte Desativação do Ações de conversa.

Vinculação de contas

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Você pode usar a vinculação de contas para conectar as Contas do Google dos seus usuários às contas de usuários no seu sistema de autenticação. Isso permite criar experiências mais avançadas para os usuários. Por exemplo, salve as preferências alimentares ou músicas 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, Web ou Android), você pode 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 do 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.

Entender o fluxo de vinculação de contas

Quando o Google Assistente associa uma Conta do Google a um usuário, você pode usar a vinculação de contas 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 conta no seu sistema de autenticação para um novo usuário.

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

Login do Google

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

Com o Login do Google no 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 simples.

Esse tipo de vinculação de conta é recomendado se qualquer um dos seguintes motivos se aplicar:

  • Você não tem um sistema de autenticação.
  • Você já tem um sistema de autenticação e quer vincular apenas usuários que se inscreveram nos seus apps 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 baseada em OAuth

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

A vinculação "Simplificada" do Login do Google baseada em OAuth (em inglês) adiciona o Login do Google a uma vinculação de conta baseada em OAuth. Isso fornece uma vinculação por voz integrada para usuários do Google, além de ativar a vinculação de contas para usuários que se registraram no seu serviço com uma identidade que não seja do Google.

Para usar esse fluxo, é necessário estender um dos fluxos padrão compatíveis com o OAuth 2.0 para adicionar suporte para extensões proprietárias do protocolo do Google, que permitem:

  • Vincule contas com facilidade 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 contas é recomendado se você tem um sistema de autenticação e quer permitir que os usuários se conectem a endereços que não sejam do @gmail.com.

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

Vinculação do OAuth

O tipo de vinculação do OAuth oferece suporte a dois fluxos padrão do setor, o OAuth 2.0, 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ê já tiver uma implementação de um servidor OAuth 2.0 e não puder estender o endpoint de troca de token para adicionar suporte aos protocolos do Google para vinculação automática e criação de contas de um token de ID.

Para saber mais, consulte o Guia do conceito 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: