Suite Google Home Test

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

Cloud-to-cloud SDK Local Home

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.

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

  • Vérifie que les rapports State State (État du rapport) et Request Sync (Synchronisation des requêtes) 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 à ceux 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 appareil et maison connectée. Le Test Suite nécessite que vous vous connectiez pour inspecter les appareils de votre Google Home Graph et envoyer des 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é en haut à droite.

  3. Configurez les détails du projet:

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

    1. Si vous certifiez l'action de votre maison connectée, laissez 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 l'action de votre 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 été modifiée dans Home Graph. Les actions de modification ont lieu via l'intégration que vous testez. Votre intégration testée doit toujours être associée à au moins un appareil.

    3. Si vous utilisez une caractéristique Scene, sélectionnez Test Scene .

  5. Effectuez une exécution du 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 soumission:

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

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

Test de validation de l'association de comptes

L'association de compte joue un rôle important dans l'écosystème des maisons connectées 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 vérifier qu'ils ont un format valide et qu'ils 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 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 expirable contient 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 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 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"} à 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 échoue. Pour en savoir plus, consultez la section 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 requêtes de jeton d'actualisation. 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. La date 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 requête 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, afin d'éviter les conditions de concurrence susceptibles 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 Résolution du problème
L'API HomeGraph n'a jamais été utilisée dans le projet <_id_> ou est désactivée Assurez-vous d'avoir activé l'API HomeGraph.
Entité demandée introuvable Vérifiez que votre agentUserId est valide et qu'elle est 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 de consentement.
  1. Suivez les instructions de la section 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 et vérifiez les autorisations suivantes pour "Suite de tests pour la maison connectée" :
    • Informations générales 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. Utilisez votre Assistant : accès étendu à votre compte Google
      2. Inspecter et contrôler les appareils connectés de votre Home Graph
    S'il manque quelqu'un, supprimez d'abord l'accès et accordez toutes les autorisations sur l'écran de consentement lorsque vous vous reconnectez.

Envoyer les résultats du test

Vos résultats Test Suite doivent réussir 100% des tests avant d'envoyer votre formulaire de certification. Si vous avez des caractéristiques qui nécessitent des tests manuels, vous devez tout de même exécuter l'outil Test Suite et 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 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 du test.
  3. Cliquez sur ACCÉDER AU FORMULAIRE D'ENVOI pour envoyer les résultats du test à Google.
  4. Renseignez tous les champs obligatoires, puis cliquez sur Envoyer.