A vinculação de apps do Google baseada no OAuth permite que os usuários vinculem as contas deles com facilidade e rapidez no sistema de autenticação às Contas do Google. Se o app for instalado no smartphone do usuário quando ele iniciar o processo de vinculação da conta, ele será virado para o app e 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 autenticação. Em vez disso, o App Flip usa as credenciais da conta do usuário no aplicativo. Depois de vincular a Conta do Google ao aplicativo, o usuário pode aproveitar as integrações que você desenvolveu.
Você pode configurar o App Flip em apps iOS e Android.
![Esta figura mostra as etapas para um usuário vincular a Conta do Google
ao seu sistema de autenticação. A primeira captura de tela mostra como um usuário
pode selecionar o app se a Conta do Google dele estiver vinculada ao app.
A segunda captura de tela mostra a confirmação da vinculação
da Conta do Google ao app. A terceira captura de tela mostra uma
conta de usuário vinculada com sucesso no Google app.](https://google-developers.gonglchuangl.net/static/identity/images/app-flip-flow.png?hl=pt)
Requisitos
Para implementar o App Flip, você precisa atender aos seguintes requisitos:
- É preciso ter um app Android ou iOS.
- É necessário ter, gerenciar e manter um servidor OAuth 2.0 compatível com o fluxo de 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
Nesta seção, descrevemos os requisitos de design e as recomendações para a tela de consentimento da vinculação da conta do AppFlip. Depois que o Google chamar o app, ele exibirá a tela de consentimento ao usuário.
Requisitos
- Você precisa comunicar que a conta do usuário está sendo vinculada ao Google, e não a um produto específico, como o Google Home ou 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 dizer ao usuário quais dados o Google exige e por quê.
Call-to-action clara. Insira uma call-to-action clara na tela de consentimento, como "Aceitar e vincular". Isso ocorre porque os usuários precisam entender quais dados eles precisam compartilhar com o Google para vincular as contas.
Opção de cancelamento. Ofereça aos usuários a opção de voltar ou cancelar.
Capacidade de desvincular. Ofereça um mecanismo para os usuários desvincularem, como um URL para as configurações da conta na plataforma. Se preferir, inclua um link para a Conta do Google em que os usuários possam gerenciar a conta vinculada.
É possível mudar a conta de usuário. Sugerir um método para os usuários trocarem de conta. Isso é útil principalmente quando os usuários costumam 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 o usuário possa fazer login na conta desejada com vinculação do OAuth e o fluxo implícito.
Inclua seu logotipo. Exiba o logotipo da sua empresa na tela de consentimento. Use suas diretrizes de estilo para inserir o logotipo. Se você também quiser exibir o logotipo do Google, consulte Logotipos e marcas registradas.
![A figura mostra um exemplo de tela de consentimento com chamadas para os requisitos individuais e recomendações que serão seguidas quando você criar uma tela de consentimento do usuário.](https://google-developers.gonglchuangl.net/static/identity/images/app-flip-guidance.png?hl=pt)
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.