Une fois que vous avez implémenté OAuth 2.0, vous pouvez configurer des App Flip basées sur OAuth, ce qui permet à vos utilisateurs Android d'associer plus rapidement leurs comptes dans votre système d'authentification à leurs comptes Google. Les sections suivantes expliquent comment concevoir et implémenter App Flip pour votre intégration Cloud-to-cloud.
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
- You must have a Google authorization statement such as "Once linked, Google will have permission to control your devices."
- 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.
- You must state a clear call-to-action on your consent screen and use the wording "Agree and link" for linking action. This is because users need to understand what data they're required to share with Google to link their accounts.
- You must provide a way for users to go back or cancel, if they choose not to link. Use the wording "Cancel" for the cancel action.
- You must implement this workflow: After clicking "Agree and link", you must show linking success and redirect the user back to the Google Home app automatically. The user should now see the linked device on the Google Home app with your action. After clicking "Cancel" you should redirect the user back to the Google Home app.
Recommendations
We recommend that you do the following:
Display Google's Privacy Policy. Include a link to Google's Privacy Policy on the consent screen.
Data to be shared. Use clear and concise language to tell the user what data of theirs Google requires and why.
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.
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.
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.
Configurer pour App Flip basé sur OAuth
Les sections suivantes décrivent les conditions préalables à l'utilisation d'App Flip basé sur OAuth et comment configurer votre projet App Flip dans la console de développement Google Home.
Créer une intégration cloud à cloud et configurer un serveur OAuth 2.0
Avant de pouvoir configurer App Flip, vous devez effectuer les opérations suivantes:
- Configurez un serveur OAuth 2.0. Pour en savoir plus sur la configuration d'un serveur OAuth, consultez Implémenter un serveur OAuth 2.0.
- Créez une intégration cloud à cloud. Pour créer une intégration, suivez les instructions de la section Créer une intégration cloud à cloud.
Configurer le basculement d'application dans la console du développeur
La section suivante explique comment configurer le basculement d'application dans la console du développeur.
- Renseignez tous les champs sous Informations sur le client OAuth. (Si App Flip n'est pas compatible, OAuth standard est utilisé en remplacement.)
- Sous Utiliser votre application pour l'association de comptes(facultatif), cochez Activer pour iOS.
- Renseignez le champ Universal Link (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.
- Si vous souhaitez configurer votre client, ajoutez des portées et cliquez sur Ajouter une portée sous Configurer votre client (facultatif).
- 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 pour accepter un lien profond de Google.
Tester App Flip sur votre appareil
Maintenant que vous avez créé une intégration cloud à cloud et configuré le basculement d'application dans la console et dans votre application, vous pouvez tester le basculement d'application sur votre appareil mobile. Vous pouvez utiliser l'application Google Home pour tester le basculement d'application.
Pour tester App Flip à partir de l'application Google Home, procédez comme suit:
- Accédez à la console de développement, puis sélectionnez votre projet.
- Accédez à Cloud à cloud > Test.
- Déclenchez le parcours d'association de compte depuis l'application Home:
- Ouvrez Google Home app (GHA).
- Cliquez sur le bouton +.
- Cliquez sur Configurer un appareil.
- Cliquez sur Vous avez déjà configuré des appareils ?.
- Sélectionnez votre intégration cloud à cloud dans la liste des fournisseurs. Il sera précédé de "[test]" dans la liste. Lorsque vous sélectionnez votre intégration [test] dans la liste, votre application devrait s'ouvrir.
- Vérifiez que votre application a été lancée, puis commencez à tester votre flux d'autorisation.