Suite Smart Testing

La suite de tests pour la maison connectée est une application Web qui vous permet de tester vous-même votre action pour la maison connectée. La suite de tests 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 afficher les résultats du test ou remplir le formulaire d'envoi pour envoyer les résultats à Google.

Les tests exécutés par la suite de tests incluent, sans s'y limiter, les tests suivants:

  • Vérifie que les paramètres Report State et Request Sync sont mis en œuvre 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.

Pour lancer l'outil de suite de test, cliquez sur le bouton ci-dessous:

Lancer une suite test

Auto-tester votre action

La section suivante décrit comment exécuter la suite de tests sur votre appareil et sur votre projet Action pour la maison connectée. La suite de tests nécessite que vous vous connectiez pour pouvoir inspecter les appareils de votre Home Graph et envoyer des commandes directement à l'Assistant Google.

Pour tester vous-même votre action, procédez comme suit:

  1. Dans votre navigateur Web, ouvrez la suite de tests pour la maison connectée.
  2. Connectez-vous à Google via le bouton situé en haut à droite.

  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 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 sont effectuées au cours de l'intégration que vous testez. Au moins un appareil doit être associé à l'utilisateur de l'agent pour que l'intégration testée soit testée.

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

  5. Exécutez une test test et consultez 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 du test 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 des comptes joue un rôle important dans l'écosystème de la maison connectée Google. Le test de validation de l'association de comptes dans Test Suite vérifie si votre service OAuth comporte des 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 afin de s'assurer que leur format est valide et qu'ils sont renvoyés avec un jeton d'actualisation valide.

Éléments test Explanation
Vérifier si le jeton d'accès est au format JWT L'association de comptes Google ne recommande pas les jetons d'accès au format JWT. Si un format JWT est détecté, 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 expirable contient un jeton d'actualisation. Vous devez fournir un jeton d'actualisation lorsque le jeton d'accès arrive à expiration. 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 afin de s'assurer que le point de terminaison d'échange de jetons les échange correctement contre de nouveaux jetons d'accès.

Éléments test Explanation
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 réponse à une requête de jeton d'actualisation non valide. Si la réponse ne correspond pas au code ou au message d'erreur, ce scénario de test échoue. Pour en savoir plus, consultez la page Jetons d'actualisation Exchange.
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 demandes de jeton d'actualisation. Si votre serveur fournit le même jeton d'accès, le scénario de test échoue.
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é alterné lors de l'actualisation. Nous vérifions si les jetons d'actualisation ont été modifiés après une demande de jeton d'actualisation. Si le jeton d'actualisation est modifié, votre serveur doit invalider un ancien jeton après l'utilisation d'un nouveau, afin d'éviter que les conditions de la concurrence nuisent à l'association du compte. Le test échouera si vous annulez l'ancienne valeur du jeton d'actualisation avant d'utiliser le nouveau.

Messages d'erreur

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

Message d'erreur Comment résoudre
L'API HomeGraph n'a pas été utilisée dans le projet <_id_> avant 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é à votre service.

Envoyer les résultats du test

Les résultats de votre suite de tests doivent passer les 100% tests avant d'envoyer le formulaire de certification. Si vous avez des caractéristiques qui nécessitent des tests manuels, vous devez quand même exécuter l'outil de la suite de tests et y joindre le résultat, même s'il n'a pas atteint 100%.

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

  1. Une fois que vous avez reçu vos résultats de test et que vous êtes prêt à certifier votre action pour maison connectée, cliquez sur Envoyer dans l'outil de la suite de tests.
  2. Cliquez sur le bouton TÉLÉCHARGER LES RÉSULTATS DE TEST pour récupérer vos résultats.
  3. Cliquez sur ACCÉDER AU FORMULAIRE D'ENVOI DE DONNÉES pour envoyer les résultats du test à Google.
  4. Remplissez tous les champs obligatoires, puis cliquez sur Envoyer.