Aperçu

借助基于 OAuth 的应用快速关联 (App Flip),您的用户可以轻松快速地将其在您的身份验证系统中的账号与其 Google 账号相关联。如果用户在发起账号关联流程时您的应用已安装在其手机上,系统会将用户顺畅地转到您的应用以获取用户授权。

这种方法可简化关联流程,因为用户无需重新输入用户名和密码即可进行身份验证;相反,App Flip 会利用用户在您应用中的账号凭据。用户将其 Google 账号与您的应用相关联后,便可使用您开发的任何集成。

您可以为 iOS 和 Android 应用设置应用快速关联。

此图展示了用户将其 Google 账号与您的身份验证系统相关联的步骤。第一个屏幕截图显示了如果用户的 Google 账号已与您的应用相关联,他们可以如何选择您的应用。第二个屏幕截图显示了确认将 Google 账号与您的应用相关联的操作。第三个屏幕截图显示了 Google 应用中已成功关联的用户账号。
图 1. 在用户手机上使用 App Flip 进行账号关联。

要求

如需实现应用翻转,您必须满足以下要求:

  • 您必须拥有 Android 或 iOS 应用。
  • 您必须拥有、管理和维护一个支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。

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.