A vinculação de apps com base em OAuth (App Flip) permite que os usuários vinculem as contas no sistema de autenticação às Contas do Google com facilidade e rapidez. Se o app estiver instalado no smartphone do usuário quando ele iniciar o processo de vinculação da conta, ele será transferido para o app para receber a autorização do usuário.
Essa abordagem oferece um processo de vinculação mais rápido e fácil, já que o usuário não precisa inserir novamente o nome de usuário e a senha para fazer a autenticação. Em vez disso, o App Flip aproveita as credenciais da conta do usuário no seu app. Depois que um usuário vincula a Conta do Google ao seu app, ele pode aproveitar todas as integrações que você desenvolveu.
É possível configurar a vinculação no app para iOS e Android.
Requisitos
Para implementar o recurso, você precisa atender aos seguintes requisitos:
- Você precisa ter um app Android ou iOS.
- Você precisa ter, gerenciar e manter um servidor OAuth 2.0 compatível com o fluxo do código de autorização do OAuth 2.0.
Para mais informações sobre o fluxo do código de autorização de vinculação do OAuth, consulte Implementar seu servidor OAuth.
Diretrizes de design
Esta seção descreve os requisitos de design e as recomendações para a tela de consentimento da vinculação de contas do App Flip. Depois que o Google chamar seu app, ele exibirá a tela de consentimento ao usuário.
Requisitos
- Informe que a conta do usuário está sendo vinculada ao Google, e não a um produto específico, como o Google Home ou o Google Assistente.
Recomendações
Portanto, recomendamos que você faça o seguinte:
Exibir a Política de Privacidade do Google. Inclua um link para a Política de Privacidade do Google na tela de consentimento.
Dados a serem compartilhados. Use uma linguagem clara e concisa para informar ao usuário quais dados do Google são necessários e por quê.
Call-to-action clara. Informe uma call-to-action clara na tela de consentimento, como "Concordar e vincular". Isso é necessário porque os usuários precisam entender quais dados eles precisam compartilhar com o Google para vincular as contas.
Possibilidade de cancelamento. Ofereça uma maneira de voltar ou cancelar, se o usuário não quiser fazer a vinculação.
Possibilidade de desvincular. Ofereça um mecanismo para os usuários desvincularem, como um URL para as configurações da conta deles na sua plataforma. Outra opção é incluir um link para uma Conta do Google em que os usuários possam gerenciar as próprias contas vinculadas.
Capacidade de mudar a conta do usuário. Sugerir um método para os usuários mudarem as contas. Isso é especialmente benéfico se os usuários tendem a ter várias contas.
- Se um usuário precisar fechar a tela de consentimento para alternar entre contas, envie um erro recuperável ao Google para que ele possa fazer login na conta desejada com a vinculação ao OAuth e o fluxo implícito.
Inclua seu logotipo. Mostre o logotipo da sua empresa na tela de consentimento. Use suas diretrizes de estilo para posicionar o logotipo. Se você também quiser exibir o logotipo do Google, consulte Logotipos e marcas registradas.
Configurar a conversão de apps com base em OAuth
As seções a seguir descrevem os pré-requisitos do App Flip com base em OAuth e como configurar seu projeto do App Flip no Console do Actions.
Criar uma ação e configurar um servidor OAuth 2.0
Antes de configurar a virada de app, faça o seguinte:
- Crie uma ação. Para criar uma ação, siga as instruções na seção Criar um projeto.
- Configure um servidor OAuth 2.0. Para mais informações sobre como configurar um servidor OAuth, consulte Implementar a vinculação de conta OAuth.
Configurar o App Flip no Console do Actions
A seção a seguir descreve como configurar o App Flip no Console do Actions.
- Clique em Desenvolver na navegação superior. Depois, clique em Vinculação de contas no painel de navegação à esquerda.
- Alterne a chave ao lado de Vinculação de contas.
- Em Criação de conta, selecione Não, quero permitir apenas a criação de contas no meu site.
- Clique em Next.
- Em Tipo de vinculação, selecione OAuth e Código de autorização nos menus suspensos.
- Clique em Next.
- Preencha todos os campos de Informações do cliente OAuth. Se o App Flip não tiver suporte, o OAuth normal será usado como substituto.
- Clique em Next.
- Em Use seu app para vinculação de contas (opcional), marque Ativar para iOS.
- Preencha o campo Link universal. Para mais informações sobre links universais, consulte Como permitir que apps e sites sejam vinculados ao seu conteúdo .
- Se você quiser configurar seu cliente, adicione escopos e clique em Adicionar escopo em Configurar seu cliente (opcional). Caso contrário, clique em Próxima.
- Em Instruções de teste, digite
test(ou qualquer outra string) como marcador de posição. O preenchimento desse campo com uma conta de teste só é necessário se você estiver realmente enviando a Ação para ser publicada. - Clique em Salvar.
Na próxima seção, você pode implementar o App Flip no seu app para iOS ou Android.
Implementar a App Flip nos seus aplicativos nativos
Para implementar o App Flip, é necessário modificar o código de autorização do usuário no seu app para aceitar um link direto do Google.
Testar o App Flip no seu dispositivo
Agora que você criou uma ação e configurou o App Flip no console e no seu app, pode testar o App Flip no seu dispositivo móvel. Você pode usar o app Google Assistente para testar o App Flip.
Para testar o App Flip no app Google Assistente, siga estas etapas:
- Acesse o Console do Actions e selecione seu projeto.
- Clique em Testar na navegação da parte de cima.
- Acione o fluxo de vinculação de contas no app Google Assistente:
- Abra o app Google Assistente.
- Clique em Configurações.
- Na guia "Assistente", clique em Automação residencial.
- Clique em Adicionar(+).
- Selecione sua ação na lista de provedores. Ele será prefixado com "[test]" na lista. Quando você selecionar a ação [test] na lista, o app será aberto.
- Verifique se o aplicativo foi iniciado e comece a testar o fluxo de autorização.