Aperçu

L'association d'application basée sur OAuth (App Flip) permet à vos utilisateurs d'associer facilement et rapidement leurs comptes Google dans votre système d'authentification. Si votre application est installée sur le téléphone de l'utilisateur lorsqu'il lance le processus d'association de compte, il est redirigé vers votre application pour obtenir l'autorisation de l'utilisateur.

Cette approche offre un processus d'association plus rapide et plus facile, car l'utilisateur n'a pas besoin de saisir à nouveau son nom d'utilisateur et son mot de passe pour s'authentifier. Au lieu de cela, App Flip exploite les identifiants du compte de l'utilisateur dans votre application. Une fois qu'un utilisateur a associé son compte Google à votre application, il peut profiter de toutes les intégrations que vous avez développées.

Vous pouvez configurer l'app flip pour les applications iOS et Android.

Cette figure montre comment un utilisateur doit associer son compte Google à votre système d'authentification. La première capture d'écran montre comment un utilisateur peut sélectionner votre application si son compte Google y est associé. La deuxième capture d'écran montre la confirmation de l'association de son compte Google à votre application. La troisième capture d'écran montre un compte utilisateur associé avec succès dans l'application Google.
Figure 1 Association de compte sur le téléphone d'un utilisateur avec App Flip.

Conditions requises

Pour implémenter le basculement d'application, vous devez remplir les conditions suivantes:

  • Vous devez disposer d'une application Android ou iOS.
  • Vous devez posséder, gérer et entretenir un serveur OAuth 2.0 compatible avec le flux avec code d'autorisation OAuth 2.0.

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

Design guidelines

This section describes the design requirements and recommendations for the App Flip account linking consent screen. After Google calls your app, your app displays the consent screen to the user.

Requirements

  1. You must communicate that the user’s account is being linked to Google, not to a specific Google product, such as Google Home or Google Assistant.

Recommendations

We recommend that you do the following:

  1. Display Google's Privacy Policy. Include a link to Google’s Privacy Policy on the consent screen.

  2. Data to be shared. Use clear and concise language to tell the user what data of theirs Google requires and why.

  3. Clear call-to-action. State a clear call-to-action on your consent screen, such as “Agree and link.” This is because users need to understand what data they're required to share with Google to link their accounts.

  4. Ability to deny or cancel. Provide a way for users to go back, deny, or cancel, if they choose not to link.

  5. Ability to unlink. Offer a mechanism for users to unlink, such as a URL to their account settings on your platform. Alternatively, you can include a link to Google Account where users can manage their linked account.

  6. Ability to change user account. Suggest a method for users to switch their account(s). This is especially beneficial if users tend to have multiple accounts.

    • If a user must close the consent screen to switch accounts, send a recoverable error to Google so the user can sign in to the desired account with OAuth linking and the implicit flow.

  7. Include your logo. Display your company logo on the consent screen. Use your style guidelines to place your logo. If you wish to also display Google's logo, see Logos and trademarks.

This figure shows an example consent screen with call-outs to the individual requirements and recommendations to be followed when you design a user consent screen.
Figure 2. Account linking consent screen design guidelines.

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.