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=19&hl=es)
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.
Pautas de diseño
En esta sección, se describen los requisitos de diseño y las recomendaciones para la pantalla de consentimiento de vinculación de cuentas en apps. Después de que Google llama a tu app, esta muestra la pantalla de consentimiento al usuario.
Requisitos
- Debes comunicar que la cuenta del usuario está vinculada a Google, no a un producto específico de Google, como Google Home o Asistente de Google.
Recomendaciones
Te recomendamos que hagas lo siguiente:
Muestra la Política de Privacidad de Google. Incluye un vínculo a la Política de Privacidad de Google en la pantalla de consentimiento.
Datos que se compartirán. Utiliza un lenguaje claro y conciso para indicarle al usuario qué datos de Google requiere y por qué.
Llamado a la acción claro. Indica un llamado a la acción claro en tu pantalla de consentimiento, como "Aceptar y vincular". Esto se debe a que los usuarios deben comprender qué datos deben compartir con Google para vincular sus cuentas.
Capacidad de cancelación. Proporciona a los usuarios una forma de regresar o cancelar si deciden no vincularse.
Capacidad de desvinculación. Ofrece un mecanismo para que los usuarios se desvinculen, como una URL que dirige a la configuración de su cuenta en tu plataforma. Como alternativa, puedes incluir un vínculo a la Cuenta de Google en la que los usuarios puedan administrar su cuenta vinculada.
Capacidad para cambiar la cuenta de usuario Sugerir un método para que los usuarios cambien sus cuentas Esto es especialmente beneficioso si los usuarios tienden a tener varias cuentas.
- Si un usuario debe cerrar la pantalla de consentimiento para cambiar de cuenta, envía un error recuperable a Google a fin de que el usuario pueda acceder a la cuenta deseada con la vinculación de OAuth y el flujo implícito.
Incluya su logotipo. Muestre el logotipo de su empresa en la pantalla de consentimiento. Usa tus lineamientos de estilo para ubicar tu logotipo. Si también deseas mostrar el logotipo de Google, consulta Logotipos y marcas.
![En esta figura, se muestra un ejemplo de una pantalla de consentimiento con menciones de requisitos individuales y recomendaciones que se deben seguir cuando se diseña una pantalla de consentimiento del usuario.](https://developers-dot-devsite-v2-prod.appspot.com/static/identity/images/app-flip-guidance.png?authuser=19&hl=es)
Implementa App Flip en tus apps nativas
Para implementar App Flip, debes modificar el código de autorización del usuario en tu app a fin de aceptar un vínculo directo de Google.
Si deseas admitir App Flip en tu app para Android, sigue las instrucciones de la Guía de implementación de Android.
Si quieres admitir App Flip en tu app para iOS, sigue las instrucciones de la guía de implementación de iOS.
Prueba de cambio de app
App Flip se puede simular con apps de muestra y de prueba antes de que estén disponibles las apps de producción verificadas y un servidor de OAuth 2.0 que funcione.
Durante la vuelta a la app, Google app primero abrirá tu app y, luego, solicitará una respuesta con código de autorización al servidor de OAuth 2.0. En el paso final, se mostrará la respuesta en Google app.
Requisitos previos
Para simular una app de Google y activar el intent que inicia tu app, descarga y, luego, instala la herramienta de prueba de Flip de App para iOS y Android.
Descarga y, luego, instala la app de ejemplo de Flip para iOS y Android a fin de simular tu app y seleccionar un tipo de respuesta de OAuth 2.0.
Secuencia de prueba
- Abre la Herramienta de prueba de Flip de la app.
- Presiona
Try Flip!
para iniciar la app de ejemplo de Flip de la app. - Selecciona una respuesta de los botones de selección en la aplicación de muestra.
- Presiona
Send
para mostrar una respuesta de OAuth 2.0 simulada a la herramienta de prueba. - Revisa los mensajes de registro de Test Tool para ver detalles de error o código de autenticación.
Pruebas de producción
Se puede probar App Flip en fase de producción después de completar el registro y la implementación del servidor de OAuth 2.0.
Para la prueba automatizada, se recomienda tener una sola Cuenta de Google y una dirección de correo electrónico específica de tareas.
El estado de vinculación de las cuentas se puede ver mediante Cuentas vinculadas cuando accedes como titular de la Cuenta de Google. Las cuentas se pueden desvincular entre pruebas repetidas desde aquí también.
De forma opcional, puedes implementar RISC para desvincular y notificar a Google de manera programática el cambio.