Attention ! Les nouveaux programmes Preview développeur seront bientôt disponibles. Inscrivez-vous ici et soyez l'un des premiers à essayer les nouveaux outils et donner votre avis.

Suite Google Home Test

Cloud à cloud    SDK Local Home

Google Home Test Suite est une application Web qui vous permet de 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és à votre compte. Une fois les tests effectués, vous pouvez les afficher 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 les options Report State et Request Sync sont implémentées 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 du rapport d'état.

Pour lancer l'outil Test Suite, cliquez sur le bouton ci-dessous:

Lancer Test Suite

Tester automatiquement votre action

La section suivante explique comment exécuter Test Suite sur votre projet d'action pour l'appareil et la maison connectée. Test Suite exige que vous vous connectiez pour 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:

  1. Dans votre navigateur Web, ouvrez Test Suite.
  2. Connectez-vous à Google via le bouton en haut à droite.

  3. Configurez Project Details (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 votre action de maison connectée, laissez la valeur par défaut État du rapport/Délai de synchronisation de la requête inchangée. Toutefois, pour les tests, vous pouvez modifier le délai avant expiration si votre agent a besoin de plus de temps pour signaler l'état à Home Graph.
    2. Si vous certifiez votre action de maison connectée, assurez-vous que l'option Test Request Sync 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 le 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 (Scène), 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 Prise en charge de la requête locale si l'appareil peut gérer l'intent QUERY en local.
  5. Exécutez 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 qui font l'objet de tests.
  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 d'admissions.

Test de validation de l'association de comptes

L'association de compte 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 du jeton 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 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 expirant contient un jeton d'actualisation. Vous devez fournir un jeton d'actualisation lorsque le jeton d'accès expire. Ce test échoue si aucun jeton d'actualisation n'est trouvé.

Actualiser le test de validation des jetons

Les jetons d'actualisation sont testés pour s'assurer 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, ce qui permet de vérifier la réponse du partenaire. Votre serveur doit renvoyer une erreur HTTP 400 Bad Request avec {"error": "invalid_grant"} en cas de 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 É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 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 jeton d'accès expire.
Vérifiez si le jeton d'actualisation a été alterné pendant 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 un ancien jeton qu'après l'utilisation d'un nouveau jeton, afin d'éviter que les conditions de concurrence ne rompent l'association de comptes utilisateur. Le test échoue 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 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.

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.

Erreur de récupération des données du module: erreur getModuleData: réponse de l'échec HTTP pour https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  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 de base du compte
      1. Afficher l'adresse e-mail principale associée à votre compte Google
      2. Consulter 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
    Si vous recevez un message d'erreur d'autorisation, 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 l'ensemble 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 associer le résultat même s'il n'est pas passé à 100%.

Pour envoyer vos résultats de test et certifier l'action de votre 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. Remplissez tous les champs obligatoires, puis cliquez sur Envoyer.