歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。

Google Home 測試套件

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Google Home Test Suite 是一款網頁應用程式,可讓您自行測試智慧住宅動作。Test Suite 會根據與您帳戶相關聯的裝置和特性,自動產生並執行測試案例。完成測試後,您可以查看測試結果或填寫提交表單,將測試結果提交給 Google。

Test Suite 執行的測試包括但不限於以下項目:

  • 請檢查裝置和裝置是否已啟用報表狀態要求同步功能。

  • 確認裝置已實作 QUERY 意圖,其結果與報告狀態結果相符。

如要啟動 Test Suite 工具,請點擊以下按鈕:

啟動「Test Suite

自行測試動作

本節說明如何在裝置和智慧型住宅動作專案中執行 Test SuiteTest Suite 要求您登入,以便檢查 Google Home Graph 中的裝置,並將指令直接傳送至 Google Assistant

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

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

  3. 設定專案詳細資料

    1. 在「Project ID」(專案 ID) 欄位中,輸入智慧住宅動作的專案 ID。
    2. 按一下「Next」(下一步)
  4. 調整「Test Settings」(測試設定)

    1. 如要認證智慧型住宅動作,請將預設的「Report State/Request Sync Timeout」值保持不變。不過,為了測試,如果代理程式需要花費較多時間將狀態回報給 Home Graph,可以變更逾時值。
    2. 如要驗證智慧型住宅動作,請確認已啟用「Test Request Sync」選項;在測試期間,系統會提示您新增、更新或移除裝置,並檢查 Home Graph 中的裝置清單是否已變更。變更動作可透過您測試的整合功能進行。測試中的整合必須至少將一個裝置連接到代理程式使用者。

    3. 如果您使用場景特性,請選取「測試場景」特性

  5. 執行測試執行並查看結果:

    1. 點選「Next」(下一步) 開始執行測試。介面會列出目前正在測試的裝置和特性。
  6. 查看「結果與提交」頁面:

    1. 測試完成後,按一下「Next」(下一步) 即可查看結果。

測試結果包含通過和失敗的測試數量,以及代表通過百分比的最終分數。

帳戶連結驗證測試

帳戶連結在 Google 智慧型住宅生態系統中扮演著重要角色。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.
檢查過期的存取權杖有更新權杖。 存取權杖到期時,必須提供重新整理權杖。 如果找不到重新整理權杖,這項測試就會失敗。

重新整理權杖驗證測試

系統會測試更新權杖,確保您的權杖交換端點可正確交換新存取權杖。

測試項目 說明
重新整理權杖無效、更新合作夥伴回應。 您的伺服器應將含有 {"error": "invalid_grant"} 的 HTTP 400 錯誤要求錯誤傳回無效的重新整理權杖要求。如果回應與「錯誤代碼或訊息」不符,這個測試案例就會失敗。詳情請參閱交換更新權杖的存取權杖
測試存取權杖後,是否已更新存取權杖。 應傳回新的存取權杖以回應重新整理權杖要求。如果您的伺服器提供相同的存取權杖,測試案例就會失敗。
確認未過期的存取權杖是否仍有效。 系統會顯示存取權杖到期時間。
檢查重新整理權杖是否已在重新整理期間旋轉。 我們會檢查重新整理權杖要求後是否有更新權杖。如果重新整理權杖已變更,則伺服器只有在使用新的重新整理權杖後,才讓舊重新整理權杖失效,以避免競爭狀況中斷使用者的帳戶連結。如果你在使用新的更新權杖前失效,測試將會失敗。

錯誤訊息

下表列出您可能會遇到的常見錯誤訊息,以及建議的解決方式。

錯誤訊息 解決方式
未曾在專案 <_id_> 中使用 HomeGraph API,或是該 API 已遭停用 確認已啟用 HomeGraph API
找不到要求的實體 請檢查您的 agentUserId 是否有效,並連結至您的服務。
請確認您具備 ${your project id} 專案的 resourcemanager.projects.get 權限,並已在同意畫面中授予所有權限。
  1. 按照排解 IAM 權限問題的說明操作,確認您的帳戶具備專案的 resourcemanager.projects.get 權限。
  2. 前往「具有您帳戶存取權的應用程式」頁面,查看下列「智慧型住宅測試套件」的權限:
    • 基本帳戶資訊
      1. 查看您的主要 Google 帳戶電子郵件地址
      2. 查看您的個人資訊,包括您已公開的任何個人資訊
    • 其他存取權
      1. 使用 Assistant:存取你的 Google 帳戶
      2. 檢查及控制 Home Graph 中的智慧住宅裝置
    如果缺少任何使用者,請先移除存取權,並在重新登入時於同意畫面中授予所有權限。

提交測試結果

您的 Test Suite 結果必須通過 100% 的測試,才能提交認證表單。如有任何需要手動測試的特性,即使結果未超過 100%,也應執行 Test Suite 工具並附加結果。

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

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