OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.
This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.
You can set up App Flip for both iOS and Android apps.
![This figure shows the steps for a user to link their Google account
to your authentication system. The first screenshot shows how a user
can select your app if their Google account is linked to your app.
The second screenshot shows the confirmation for linking their
Google account with your app. The third screenshot shows a
successfully linked user account in the Google app.](https://developers-dot-devsite-v2-prod.appspot.com/static/identity/images/app-flip-flow.png?authuser=6&hl=pt-br)
Requirements
To implement App Flip, you must fulfill the following requirements:
- You must have an Android or iOS app.
- You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.
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://developers-dot-devsite-v2-prod.appspot.com/static/identity/images/app-flip-guidance.png?authuser=6&hl=pt-br)
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.