Google Home Test Suite est une application Web qui vous permet de : et tester vous-même votre Action de 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ées à votre compte. Une fois les tests terminés, vous pouvez les consulter ou remplissez le formulaire d'envoi pour envoyer les résultats du test à Google.
Les tests exécutés par Test Suite incluent, sans s'y limiter, les suivants :
Vérifiez que Report State (État du rapport) et Request Sync sont implémentés pour votre appareils et caractéristiques.
Vérifie que l'intent QUERY est implémentée pour votre appareil et que ses résultats correspondent aux résultats du rapport sur l'état.
Vous pouvez lancer l'outil Test Suite en cliquant sur le bouton ci-dessous:
Testez votre action par vous-même
La section suivante explique comment exécuter Test Suite sur votre appareil et votre projet Action pour maison connectée. Test Suite vous oblige à vous connecter pour pouvoir inspecter les appareils de votre Google Home Graph et envoyer des commandes directement à Google Assistant
Pour tester vous-même votre action, procédez comme suit:
- Dans votre navigateur Web, ouvrez le Test Suite
Connectez-vous à Google à l'aide du bouton situé dans l'angle supérieur droit.
Configurez les détails du projet:
- Dans le champ ID du projet, saisissez l'identifiant de votre projet Action pour maison connectée.
- Cliquez sur Suivant.
Configurez les paramètres de test:
- Si vous certifiez votre action de maison connectée, conservez la valeur par défaut La valeur Report State/Request Sync Timeout n'est pas modifiée. Toutefois, vous pouvez modifier le délai avant expiration si l'agent met plus de temps à signaler l'état à Home Graph.
Si vous certifiez votre action de maison connectée, assurez-vous que l'option Test Request Sync (Synchronisation des demandes de test) est activée. Pendant le test, vous serez invité à ajouter, mettre à jour ou supprimer un appareil et vérifier si la liste des appareils a été modifiée dans Home Graph. Les actions de modification ont lieu via l'intégration que vous êtes en train d'effectuer tests. L'intégration testée doit toujours comporter au moins un appareil à l'utilisateur de l'agent.
Si vous utilisez une caractéristique Scene, sélectionnez Caractéristique de scène de test.
Si vous exécutez la suite de tests pour les appareils Local Home, sélectionnez Compatible avec le SDK Local Home.
- Sélectionnez Traitement local ou Configuration simplifiée.
- Cliquez sur Prend en charge les requêtes locales si l'appareil peut gérer l'intent QUERY (Requête locale). localement.
Effectuez un test et affichez les résultats:
- Cliquez sur Suivant pour commencer à exécuter des tests. L'interface affiche les appareils et les traits testés.
Affichez la page Résultats et envoi :
- 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 échoués, ainsi qu'une réponse finale indiquant le pourcentage de passes.
Test de validation de l'association des comptes
L'association de comptes joue un rôle un rôle important dans l'écosystème de la maison connectée de Google. L'association de comptes test de validation dans Test Suite vérifie si votre service OAuth les problèmes potentiels.
Le test de validation d'association de comptes contient des tests permettant de valider les jetons d'accès et les jetons d'actualisation:
Test de validation du jeton d'accès
Les jetons d'accès renvoyés par votre point de terminaison d'échange de jetons sont testés pour garantir ils ont un format valide et sont renvoyés avec un jeton d'actualisation valide.
Éléments test | Explication |
---|---|
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
Le format JWT a été 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 éligible à l'expiration dispose d'un jeton d'actualisation. | Un jeton d'actualisation doit être fourni lorsque le jeton d'accès expire. Ce test échouera si aucun jeton d'actualisation n'est trouvé. |
Actualiser le test de validation du jeton
Les jetons d'actualisation sont testés pour garantir que votre point de terminaison d'échange de jetons est correct contre de nouveaux jetons d'accès.
Éléments test | Explication |
---|---|
Jeton d'actualisation dont le jeton n'est pas valide, vérification de la réponse du partenaire. | Votre serveur doit renvoyer une erreur HTTP 400 Bad Request avec
{"error": "invalid_grant"} à une requête de jeton d'actualisation non valide.
Si la réponse ne correspond pas au "code ou message d'erreur", ce scénario de test
échouera. Consulter
é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 son actualisation. | De nouveaux jetons d'accès doivent être renvoyés en réponse à l'actualisation du jeton requêtes. Si votre serveur fournit le même jeton d'accès, le scénario de test échouer. |
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 sont modifiés après une demande de jeton d'actualisation. Si le jeton d'actualisation change, votre serveur ne doit invalider qu'une ancienne actualisation après l'utilisation d'un nouveau jeton d'actualisation, pour éviter les conditions de concurrence qui pourraient rompre l'association du compte d'un utilisateur. Le test échouera si vous invalidez l'ancien jeton d'actualisation avant que le nouveau ne soit utilisé. |
Messages d'erreur
Le tableau suivant répertorie certains messages d'erreur courants que vous pourriez rencontrer et le une méthode suggérée pour les résoudre.
Message d'erreur | Résoudre le problème |
---|---|
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
Google Cloud. |
Assurez-vous de disposer de l'autorisation Erreur de récupération des données du module: erreur getModuleData: réponse d'échec HTTP pour https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Envoyer les résultats du test
Vous devez réussir 100 % des tests Test Suite avant d'envoyer votre formulaire de certification. Si vous avez des caractéristiques qui nécessitent des tests manuels, vous devez quand même exécuter l'outil Test Suite et associer le résultat même s'il n'est pas passé à 100%.
Pour envoyer les résultats de vos tests et certifier votre action pour la maison connectée, procédez comme suit :
- Une fois que vous avez reçu les résultats du test et que vous êtes prêt à certifier votre action d'accueil, cliquez sur Submit (Envoyer) dans l'outil Test Suite.
- Cliquez sur le bouton TÉLÉCHARGER LES RÉSULTATS DU TEST pour récupérer les résultats de votre test.
- Cliquez sur ACCÉDER AU FORMULAIRE D'ENVOI pour envoyer les résultats du test à Google.
Renseignez tous les champs obligatoires, puis cliquez sur Envoyer.