Aperçu

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.
Figure 1. Account linking on a user's phone with App Flip.

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.

Pour en savoir plus sur le flux de code d'autorisation d'association OAuth, consultez Implémenter votre serveur OAuth.

Principes de conception

Cette section décrit les exigences et les recommandations de conception pour l'écran de consentement à l'association de compte App Flip. Une fois que Google a appelé votre application, celle-ci affiche l'écran de consentement à l'utilisateur.

Conditions requises

  1. Vous devez indiquer que le compte de l'utilisateur est associé à Google, et non à un produit Google spécifique, tel que Google Home ou l'Assistant Google.

Recommandations

Nous vous recommandons d'effectuer les opérations suivantes :

  1. Affichez les règles de confidentialité de Google. Incluez un lien vers les Règles de confidentialité de Google sur l'écran de consentement.

  2. Données à partager : Utilisez un langage clair et concis pour indiquer à l'utilisateur les données dont Google a besoin et pourquoi.

  3. Incitation à l'action claire : Indiquez clairement l'incitation à l'action sur votre écran de consentement, par exemple "Accepter et associer". En effet, les utilisateurs doivent comprendre quelles données ils doivent partager avec Google pour associer leurs comptes.

  4. Possibilité de refuser ou d'annuler Fournissez aux utilisateurs un moyen de revenir en arrière, de refuser ou d'annuler s'ils choisissent de ne pas associer leur compte.

  5. Possibilité de dissocier le compte. Offrez aux utilisateurs un mécanisme pour dissocier leur compte, par exemple une URL vers les paramètres de leur compte sur votre plate-forme. Vous pouvez également inclure un lien vers le compte Google où les utilisateurs peuvent gérer leur compte associé.

  6. Possibilité de modifier le compte utilisateur Suggérez aux utilisateurs une méthode pour changer de compte. Cela est particulièrement utile si les utilisateurs ont tendance à posséder plusieurs comptes.

    • Si un utilisateur doit fermer l'écran d'autorisation pour changer de compte, envoyez une erreur récupérable à Google afin qu'il puisse se connecter au compte souhaité avec l'association OAuth et le flux implicite.

  7. Incluez votre logo. Affichez le logo de votre entreprise sur l'écran de consentement. Utilisez vos consignes de style pour placer votre logo. Si vous souhaitez également afficher le logo de Google, consultez Logos et marques déposées.

Cette figure montre un exemple d'écran de consentement avec des encadrés indiquant les exigences et recommandations individuelles à suivre lorsque vous concevez un écran de consentement utilisateur.
Figure 2. Consignes de conception de l'écran d'autorisation pour l'association de comptes.

Configurer App Flip basé sur OAuth

Les sections suivantes décrivent les conditions préalables pour l'échange d'applications basé sur OAuth et expliquent comment configurer votre projet d'échange d'applications dans la console Actions.

Créez une action et configurez un serveur OAuth 2.0.

Avant de pouvoir configurer App Flip, vous devez effectuer les opérations suivantes :

Configurer App Flip dans la console Actions

La section suivante explique comment configurer App Flip dans la console Actions.

  1. Dans la barre de navigation en haut de l'écran, cliquez sur Develop (Développer). Dans le panneau de navigation de gauche, cliquez sur Association de compte.
  2. Activez le bouton bascule à côté de Association de comptes.
  3. Sous Création de compte, sélectionnez Non, je souhaite uniquement autoriser la création de compte sur mon site Web.
  4. Cliquez sur Suivant.
  5. Sous Type d'association, sélectionnez OAuth et Code d'autorisation dans les menus déroulants.
  6. Cliquez sur Suivant.
  7. Renseignez tous les champs sous Informations sur le client OAuth. (Si App Flip n'est pas compatible, OAuth standard est utilisé comme solution de secours.)
  8. Cliquez sur Suivant.
  9. Sous Utiliser votre application pour l'association de compte (facultatif), cochez Activer pour iOS.
  10. Renseignez le champ Lien universel. Pour en savoir plus sur les liens universels, consultez Autoriser les applications et les sites Web à créer des liens vers votre contenu .
  11. Si vous souhaitez configurer votre client, ajoutez des niveaux d'accès et cliquez sur Ajouter un niveau d'accès sous Configurer votre client (facultatif). Si ce n'est pas le cas, cliquez sur Suivant.
  12. Sous "Instructions de test", saisissez test (ou toute autre chaîne) comme espace réservé. (Il n'est nécessaire de remplir ce champ avec un compte de test que si vous envoyez réellement votre action pour publication.)
  13. Cliquez sur Enregistrer.

Vous pouvez maintenant passer à la section suivante pour implémenter App Flip dans votre application iOS ou Android.

Implémenter App Flip dans vos applications natives

Pour implémenter App Flip, vous devez modifier le code d'autorisation de l'utilisateur dans votre application afin d'accepter un lien profond de Google.

Tester le changement d'application sur votre appareil

Maintenant que vous avez créé une action et configuré App Flip dans la console et dans votre application, vous pouvez tester App Flip sur votre appareil mobile. Vous pouvez utiliser l'application Assistant Google pour tester le transfert d'application.

Pour tester App Flip depuis l'application Assistant :

  1. Accédez à la console Actions, puis sélectionnez votre projet.
  2. Dans la barre de navigation en haut de l'écran, cliquez sur Test (Tester).
  3. Déclenchez le processus d'association de compte depuis l'application Assistant :
    1. Ouvrez l'application Assistant Google.
    2. Cliquez sur Paramètres.
    3. Dans l'onglet "Assistant", cliquez sur Contrôle de la maison.
    4. Cliquez sur Ajouter(+).
    5. Sélectionnez votre action dans la liste des fournisseurs. Il sera précédé de "[test]" dans la liste. Lorsque vous sélectionnez votre action [test] dans la liste, votre application doit s'ouvrir.
    6. Vérifiez que votre application a été lancée et commencez à tester votre flux d'autorisation.