Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.

Suite Google Home Test

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Google Home Test Suite est une application Web qui vous permet de tester vous-même votre action pour la maison connectée. Test Suite génère et exécute automatiquement des scénarios de test en fonction des appareils et des caractéristiques associés à votre compte. Une fois les tests terminés, vous pouvez les consulter ou remplir le formulaire d'envoi pour envoyer les résultats à Google.

Les tests exécutés par Test Suite incluent, sans s'y limiter, les éléments suivants:

  • Vérifie que l'état du rapport et la synchronisation des requêtes sont implémentés pour vos appareils et vos caractéristiques.

  • Vérifie que l'intent QUERY est implémenté pour votre appareil et que ses résultats correspondent aux résultats de l'état du rapport.

Vous pouvez lancer l'outil Test Suite en cliquant sur le bouton ci-dessous:

Lancer Test Suite

Tester votre action

La section suivante explique comment exécuter Test Suite sur votre projet d'action pour un appareil et une maison connectée. Vous devez vous connecter à Test Suite pour pouvoir inspecter les appareils de votre Google Home Graph et envoyer les commandes directement à Google Assistant.

Pour tester automatiquement votre action, procédez comme suit:

  1. Dans votre navigateur Web, ouvrez Test Suite.
  2. Connectez-vous à Google à l'aide du bouton situé dans l'angle supérieur droit.

  3. Configurez les détails du projet :

    1. Dans le champ ID du projet, saisissez l'identifiant de votre action pour la maison connectée.
    2. Cliquez sur Next (Suivant).
  4. Configurez les paramètres de test :

    1. Si vous certifiez votre action pour la maison connectée, ne modifiez pas la valeur par défaut Report State/Request Sync Timeout. Toutefois, à des fins de test, vous pouvez modifier le délai avant expiration si votre agent prend plus de temps pour signaler l'état à Home Graph.
    2. Si vous certifiez votre action pour la maison connectée, assurez-vous que l'option Tester la synchronisation des requêtes est activée. Lors des tests, vous serez invité à ajouter, mettre à jour ou supprimer un appareil et à vérifier si la liste des appareils a changé dans Home Graph. Les actions de modification se produisent via l'intégration que vous testez. L'intégration testée doit toujours être associée à au moins un appareil.

    3. Si vous utilisez une caractéristique Scene, sélectionnez Tester la caractéristique Scène.

    4. Si vous exécutez la suite de tests pour des appareils Local Home, sélectionnez Compatible avec le SDK Local Home.

      1. Sélectionnez Fulfillment local ou Configuration aisée.
      2. Cliquez sur Compatible avec la requête locale si l'appareil peut gérer l'intent QUERY en local.
  5. Effectuez un test test et affichez les résultats:

    1. Cliquez sur Suivant pour commencer à exécuter des tests. L'interface affiche les appareils et les caractéristiques testés.
  6. Consultez la page Résultats et envoi:

    1. Une fois les tests terminés, cliquez sur Suivant pour afficher les résultats.

Les résultats incluent le nombre de tests réussis et ayant échoué, ainsi qu'un score final indiquant le pourcentage de réussites.

Test de validation de l'association de comptes

L'association de comptes joue un rôle important dans l'écosystème de la maison connectée de Google. Le test de validation de l'association de comptes dans Test Suite vérifie que votre service OAuth ne présente pas de problèmes potentiels.

Le test de validation de l'association de comptes contient des tests permettant de valider les jetons d'accès et les jetons d'actualisation :

Test de validation des jetons d'accès

Les jetons d'accès renvoyés par votre point de terminaison d'échange de jetons sont testés pour s'assurer qu'ils ont un format valide et qu'ils sont renvoyés avec un jeton d'actualisation valide.

Éléments de test Explication
Vérifier si le jeton d'accès est au format JWT L'association de comptes Google ne recommande pas de jetons d'accès au format JWT. Si un format JWT est trouvé, l'avertissement suivant s'affiche : The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
Vérifiez que le jeton d'accès pouvant expirer contient un jeton d'actualisation. Un jeton d'actualisation doit être fourni lorsque le jeton d'accès peut expirer. Ce test échouera si aucun jeton d'actualisation n'est trouvé.

Actualiser le test de validation des jetons

Les jetons d'actualisation sont testés pour garantir que votre point de terminaison d'échange de jetons les échange correctement contre de nouveaux jetons d'accès.

Éléments de test Explication
Jeton d'actualisation avec un jeton d'actualisation non valide. Vérification de la réponse du partenaire... Votre serveur doit renvoyer une erreur HTTP 400 Bad Request avec {"error": "invalid_grant"} en cas de requête d'actualisation de jeton non valide. Si la réponse ne correspond pas au "code ou message d'erreur", ce scénario de test échouera. Pour en savoir plus, consultez Échanger des jetons d'actualisation contre des jetons d'accès.
Vérifiez si le jeton d'accès a été mis à jour après l'actualisation du jeton. Les nouveaux jetons d'accès doivent être renvoyés en réponse aux requêtes d'actualisation de jetons. Si votre serveur fournit le même jeton d'accès, le scénario de test échouera.
Vérifiez si le jeton d'accès non expiré est toujours valide. Le délai d'expiration du jeton d'accès s'affiche.
Vérifiez si le jeton d'actualisation a été tourné lors de l'actualisation. Nous vérifions si les jetons d'actualisation sont modifiés après une demande de jeton d'actualisation. En cas de modification du jeton d'actualisation, votre serveur ne doit invalider un ancien jeton d'actualisation qu'après l'utilisation d'un nouveau jeton d'actualisation, afin d'éviter toute situation de concurrence susceptible de rompre l'association du compte d'un utilisateur. Le test échouera si vous invalidez l'ancien jeton d'actualisation avant d'utiliser le nouveau.

Messages d'erreur

Le tableau suivant répertorie certains messages d'erreur courants que vous pouvez rencontrer et la solution suggérée pour les résoudre.

Message d'erreur Procédure de résolution
L'API HomeGraph n'a jamais été utilisée dans le projet <_id_> ou elle est désactivée Assurez-vous d'avoir activé l'API HomeGraph.
Entité demandée introuvable Vérifiez que votre agentUserId est valide et associée à votre service.
Assurez-vous de disposer de l'autorisation resourcemanager.projects.get sur le projet ${your project id} et d'avoir accordé toutes les autorisations sur l'écran d'autorisation.
  1. Suivez les instructions de la page Résoudre les problèmes liés aux autorisations IAM pour vous assurer que votre compte dispose des autorisations resourcemanager.projects.get pour le projet.
  2. Accédez à la page Applications ayant accès à votre compte afin de vérifier les autorisations suivantes pour "Suite de tests pour la maison connectée" :
    • Informations de base sur le compte
      1. Afficher l'adresse e-mail principale associée à votre compte Google
      2. Afficher vos informations personnelles, y compris celles que vous avez rendues publiques
    • Accès supplémentaire
      1. Utiliser votre Assistant : accès étendu à votre compte Google
      2. Inspectez et contrôlez vos appareils connectés dans votre Home Graph
    S'il manque quelqu'un, retirez d'abord l'accès et accordez toutes les autorisations sur l'écran d'autorisation lorsque vous vous connectez à nouveau.

Envoyer les résultats du test

Les résultats de Test Suite doivent réussir l'ensemble des tests avant d'envoyer votre formulaire de certification. Si certaines caractéristiques nécessitent un test manuel, vous devez tout de même exécuter l'outil Test Suite et joindre le résultat même s'il n'est pas passé à 100%.

Pour envoyer vos résultats de test et certifier votre action pour la maison connectée, procédez comme suit:

  1. Une fois que vous avez reçu les résultats du test et que vous êtes prêt à certifier votre action de maison connectée, cliquez sur Envoyer dans l'outil Test Suite.
  2. Cliquez sur le bouton TÉLÉCHARGER LES RÉSULTATS DE TEST pour récupérer les résultats de votre test.
  3. Cliquez sur GO TO SUBMISSION FORM (Envoyer au formulaire d'envoi) pour envoyer les résultats du test à Google.
  4. Renseignez tous les champs obligatoires, puis cliquez sur Envoyer.