Retournement de l'application

Une fois que vous avez implémenté OAuth 2.0, vous pouvez éventuellement configurer un App Flip basé sur l'authentification, ce qui permet à vos utilisateurs d'associer plus rapidement leur compte dans votre système d'authentification à leur compte Google. Les sections suivantes décrivent comment concevoir et implémenter App Flip pour votre action smart home.

Consignes de conception

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

Conditions requises

  1. Vous devez disposer d'une déclaration d'autorisation Google telle que "Une fois l'association effectuée, Google sera autorisé à contrôler vos appareils".
  2. Vous devez indiquer que le compte de l'utilisateur est associé à Google, et non à un produit Google spécifique, comme Google Home ou l'Assistant Google.
  3. Vous devez énoncer une incitation à l'action claire sur votre écran de consentement et utiliser la formule "Accepter et associer" pour associer l'action. En effet, les utilisateurs doivent comprendre quelles données ils doivent partager avec Google pour associer leurs comptes.
  4. Vous devez permettre aux utilisateurs de revenir en arrière ou de résilier l'abonnement s'ils choisissent de ne pas effectuer l'association. Utilisez le libellé "Annuler" pour l'action d'annulation.
  5. Vous devez mettre en œuvre ce workflow: après avoir cliqué sur "Accepter et associer", vous devez afficher l'association réussie et rediriger automatiquement l'utilisateur vers l'application Google Home. L'utilisateur devrait maintenant voir l'appareil associé dans l'application Google Home avec votre action. Après avoir cliqué sur "Annuler", vous devez rediriger l'utilisateur vers l'application Google Home.

Recommandations

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

  1. Afficher les règles de confidentialité de Google Ajoutez 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 quelles données sont requises par Google et pourquoi.

  3. Possibilité de dissocier des comptes. Proposez aux utilisateurs un mécanisme de dissociation, par exemple une URL vers les paramètres de leur compte sur votre plate-forme. Vous pouvez également inclure un lien vers un compte Google permettant aux utilisateurs de gérer leur compte associé.

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

    • Si un utilisateur doit fermer l'écran de consentement pour changer de compte, envoyez à Google une erreur récupérable afin qu'il puisse se connecter au compte souhaité à l'aide de l'association OAuth et du flux implicite.
  5. Incluez votre logo. Afficher 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 la section Logos et marques.

Cette figure montre un exemple d'écran de consentement avec des accroches sur les exigences individuelles et les recommandations à suivre lorsque vous concevez un écran de consentement de l'utilisateur.
Figure 1: Consignes de conception de l'écran de consentement pour l'association de comptes.

Configurer pour le App Flip basé sur OAuth

Les sections suivantes décrivent les conditions préalables à l'utilisation du service App Flip basé sur OAuth et expliquent comment configurer votre projet App Flip dans la console Actions.

Créer une action pour la maison connectée et configurer un serveur OAuth 2.0

Avant de pouvoir configurer App Flip, vous devez procéder comme suit:

Configurer App Flip dans la console Actions

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

  1. Remplissez tous les champs sous Informations sur le client OAuth. Si App Flip n'est pas accepté, le protocole OAuth standard est utilisé en remplacement.
  2. Sous Utiliser votre application pour l'association de compte(facultatif), cochez Activer pour iOS.
  3. Remplissez le champ Lien universel. Pour en savoir plus sur les liens universels, consultez la page Autoriser des applications et des sites Web à créer des liens vers votre contenu.
  4. Si vous souhaitez configurer votre client (facultatif), ajoutez des champs d'application, puis cliquez sur Ajouter un champ d'application sous Configurer votre client (facultatif).
  5. 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 utilisateur dans votre application afin d'accepter un lien profond de Google.

Testez App Flip sur votre appareil

Maintenant que vous avez créé une action et configuré App Flip sur la console et dans votre application, vous pouvez tester App Flip sur votre appareil mobile. Vous pouvez utiliser Google Assistant app ou Google Home app (GHA) pour tester App Flip.

Pour tester App Flip à partir de Google Assistant app, procédez comme suit:

  1. Accédez à la console Actions, puis sélectionnez votre projet.
  2. Cliquez sur Tester dans la barre de navigation supérieure.
  3. Déclenchez le flux d'association de comptes à partir de l'application Google Assistant:
    1. Ouvrez Google Assistant app.
    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 est 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.

Pour tester App Flip à partir de l'application Google Home, procédez comme suit:

  1. Accédez à la console Actions, puis sélectionnez votre projet.
  2. Cliquez sur Tester dans la barre de navigation supérieure.
  3. Déclenchez le flux d'association de comptes à partir de l'application Home:
    1. Ouvrez Google Home app (GHA).
    2. Cliquez sur le bouton +.
    3. Cliquez sur Configurer un appareil.
    4. Cliquez sur Vous avez déjà configuré des appareils.
    5. Sélectionnez votre action smart home dans la liste des fournisseurs. Il est 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.