Vinculação de contas
Visão geral
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, como opção, o OAuth 2.0 (um protocolo padrão do setor para autorização).
Acesse nosso site para desenvolvedores para mais orientações técnicas.
![](https://developers.google.cn/static/assistant/conversation-design/images/account-linking-hero.png?authuser=19&hl=pt)
Fluxo de vinculação
- Encontrar uma correspondência para a conta no seu sistema de autenticação (se o usuário já tiver usado a ação ou um dos seus apps em outras plataformas)
- Criar uma nova conta no sistema de autenticação para um novo usuário
Os três métodos de vinculação
Há três métodos de vinculação de conta:
Login do Google
Com o Login do Google no Assistente, sua ação pode solicitar acesso ao perfil do Google do usuário durante uma conversa, o que inclui o nome, o endereço de e-mail e a foto do perfil. O usuário pode completar todo o fluxo por voz, o que proporciona uma experiência de login mais simples.
Use o Login do Google se:
- Suas ações segmentam apenas o Assistente
- 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 apps usando o endereço @gmail.com.
![](https://developers.google.cn/static/assistant/conversation-design/images/gsi-only-hero.png?authuser=19&hl=pt)
OAuth e Login do Google
O tipo de vinculação do OAuth e do Login do Google adiciona o Login do Google, além da vinculação de conta baseada em OAuth. Isso permite uma vinculação perfeita por voz a usuários do Google e, ao mesmo tempo, permite 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 compatíveis do OAuth 2 para adicionar suporte às extensões proprietárias do protocolo do Google.
Use o OAuth e o Login do Google se:
- Você tem Ações em várias plataformas
- Você tem um sistema de autenticação e quer permitir que os usuários se conectem a endereços que não são do @gmail.com.
- Você quer vincular contas usando as informações do perfil do Google
- Você precisa criar novas contas usando as informações do perfil do Google (opcional)
![](https://developers.google.cn/static/assistant/conversation-design/images/gsi-oauth-hero.png?authuser=19&hl=pt)
OAuth
O tipo de vinculação de conta do OAuth é compatível com dois fluxos do OAuth 2.0 padrão do setor:
- fluxos de código implícitos
- fluxos de código 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 o OAuth se:
- Você tem uma implementação existente de um servidor OAuth 2 e não pode 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 do desenvolvedor do OAuth.