Google Home 測試套件

Google Home Test Suite 是一種網頁應用程式 自我測試智慧型住宅動作Test Suite 會根據裝置和特徵自動產生及執行測試案例 。完成測試後,即可查看 結果,或是填寫提交表單,將測試結果提交給 Google。

Test Suite 執行的測試包含 (但不限於) 僅限於:

  • 系統會檢查「回報狀態」並 已為您的應用程式實作要求同步處理 裝置與特徵的討論

  • 驗證 QUERY 意圖 已完成實作,而且結果與報告狀態結果相符。

,瞭解如何調查及移除這項存取權。

按一下按鈕即可啟動 Test Suite 工具 如下:

啟動 Test Suite

自行測試動作

下一節將說明如何在以下項目中執行 Test Suite: 和 Smart Home Action 專案Test Suite 系統要求您登入,以便根據 Google Home Graph,並直接將指令傳送給 Google Assistant

如要自行測試動作,請按照下列步驟操作:

  1. 在網路瀏覽器中開啟 Test Suite
  2. 使用右上角的按鈕登入 Google。

  3. 設定「Project Details」

    1. 在「Project ID」欄位中,輸入 智慧型住宅動作。
    2. 點選「下一步」。
  4. 進行「測試設定」

    1. 如要認證智慧型住宅動作,請保留預設設定 「Report State/Request Sync Timeout」值未變更。不過, 因此,如果代理程式需要較長的時間 將狀態回報給 Home Graph。
    2. 如要認證智慧型住宅動作,請確認測試要求同步處理功能 選項,且在測試期間,系統會提示您新增 更新或移除裝置,並查看裝置清單是否有異動 Home 圖譜。系統會透過您目前整合的整合功能執行變更 進行測試。測試中的整合服務必須至少要有一部裝置 已附加至代理程式使用者

    3. 如果您使用的是 Scene 特徵,請選取 Test Scene 特性

    4. 如果您執行的是適用於本機住宅裝置的測試套件,請選取 支援 Local Home SDK

      1. 選取「本機執行要求」或「流暢設定」
      2. 如果裝置可處理 QUERY 意圖,請按一下「支援本機查詢」 本機儲存空間
  5. 執行測試執行作業並查看結果:

    1. 點選「Next」開始執行測試。介面顯示 測試的特徵和特徵
  6. 查看結果並提交頁面

    1. 測試完成後,點選「下一步」即可查看結果。

測試結果包含通過和失敗的測試數量,以及 。

帳戶連結驗證測試

帳戶連結會 扮演重要角色帳戶連結 Test Suite 中的驗證測試會檢查您的 OAuth 服務: 潛在問題。

帳戶連結驗證測試包含用於驗證存取權杖的測試 和更新權杖

存取權杖驗證測試

系統會測試從權杖交換端點傳回的存取權杖,藉此確保 須具備有效的格式,且以有效的更新權杖傳回。

測試項目 說明
確認存取權杖是否為 JWT 格式 Google 帳戶連結功能不建議採用 JWT 格式存取權杖。如果 如果找到 JWT 格式,則會看到以下警告訊息: 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.
檢查有期限的存取權杖是否有更新權杖。 當存取權杖過期時,必須提供更新權杖。 找不到更新權杖,這項測試就會失敗。

重新整理權杖驗證測試

系統會測試重新整理權杖,確保正確交換權杖交換端點 藉此交換新的存取權杖

測試項目 說明
請使用無效的更新權杖重新整理權杖,並檢查合作夥伴回應。 您的伺服器應該會傳回 HTTP 400 Bad Request 錯誤, 將 {"error": "invalid_grant"} 改為無效的更新權杖要求。 如果回應與「錯誤代碼或訊息」不符,就表示這個測試案例 失敗。造訪 交換更新權杖以獲得更多存取權杖
測試憑證更新後是否已更新存取權杖。 應傳回新的存取權杖以回應更新權杖 要求。如果您的伺服器提供相同的存取權杖,測試案例就會 失敗。
請確認未過期的存取權杖是否仍有效。 畫面上隨即會顯示存取權杖到期時間。
檢查重新整理權杖是否已在重新整理時輪替。 我們會檢查更新權杖要求後,是否會變更更新權杖。如果 更新權杖變更時,您的伺服器應只將舊的重新整理作業失效 權杖,以防止競爭狀況 可能會破壞使用者的帳戶連結。如果您 請先驗證舊的更新憑證,再使用新的憑證。

錯誤訊息

下表列出一些常見的錯誤訊息和 並建議解決方法

錯誤訊息 解決方法
專案 <_id_> 尚未使用 HomeGraph API之前或 它已停用 確認已啟用 HomeGraph API
找不到要求的實體 請確認 agentUserId 有效且已連結 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務

請確認您擁有 resourcemanager.projects.get 權限 對專案 ${your project id} 授予 授予所需的權限

取得模組資料時發生錯誤:getModuleData 錯誤:HTTP 失敗回應 適用於 https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. 請按照疑難排解 IAM 權限,確保您的帳戶具備 專案的 resourcemanager.projects.get 權限。
  2. 請前往具有您帳戶存取權的應用程式頁面,查看 下列「適用於智慧型住宅的測試套件」權限:
    • 基本帳戶資訊
      1. 查看您的主要 Google 帳戶電子郵件地址
      2. 查看您的個人資訊,包括您擁有的任何個人資訊 已公開
    • 額外存取權
      1. 使用 Assistant:廣泛存取 你的 Google 帳戶
      2. 檢查及控製家中的智慧住宅裝置 圖表
    ,瞭解如何調查及移除這項存取權。 如果系統顯示權限錯誤訊息,請先移除存取權,並授予所有 授予您權限。

提交測試結果

您的「Test Suite」結果必須通過 100% 的測試 提交認證表單。如果有某些特徵 手動測試,仍應執行 Test Suite 工具,並 即使結果尚未超過 100%,也仍會附加

如要提交測試結果及認證智慧型住宅動作,請按照下列步驟操作: 步驟如下:

  1. 收到測試結果並準備好進行智慧認證時 主畫面動作,按一下 Test Suite 工具中的「提交」
  2. 按一下「下載測試結果」按鈕,即可擷取測試結果。
  3. 按一下「前往提交表單」,將測試結果提交給 Google。
  4. 填寫所有必填欄位,然後按一下「提交」