Google Home 測試套件

雲端到雲端 Local Home SDK

Google Home Test Suite 是一種網頁應用程式，可讓您自行測試智慧住宅動作。Test Suite 會根據與帳戶相關聯的裝置和特徵，自動產生並執行測試案例。完成測試後，您可以查看測試結果。

如要使用 Test Suite，並將測試結果提交給 Google 進行認證，請參閱測試並分享智慧型家居動作頁面。這個版本的 Test Suite 專門用於開發和品質確保。

Test Suite 執行的測試包括但不限於：

檢查是否為裝置和特徵實作回報狀態和要求同步處理。
驗證 QUERY 意圖是否已為裝置實作，且其結果與「回報狀態」結果相符。

如要啟動 Test Suite 工具，請按一下下方的按鈕：

啟動 Test Suite

對動作進行自我測試

以下章節將說明如何在裝置和智慧型家居動作專案上執行 Test Suite。Test Suite 需要您登入，才能檢查 Google Home Graph 中的裝置，並直接將指令傳送至 Google Assistant。

如要對動作進行自測，請按照下列步驟操作：

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

重要事項： 請務必登入與要測試的 Cloud-to-cloud 整合項目相關聯的帳戶。
設定「Project Details」：
1. 在「Project ID」欄位中，輸入智慧型家居動作的專案 ID。
2. 點選 [下一步]。
設定「測試設定」：
1. 如果要驗證 Cloud-to-cloud 整合，請保留預設的回報狀態/要求同步處理超時值。不過，如果要進行測試，且您的服務代理需要較長時間將狀態回報至 Home Graph，您可以變更逾時值。
2. 如果要驗證 Cloud-to-cloud 整合，請務必啟用「Test Request Sync」選項。在測試期間，系統會提示您新增、更新或移除裝置，並檢查裝置清單是否已在 Home Graph 中變更。變更動作會透過您測試的整合功能進行。您測試中的整合項目必須隨時至少有一個裝置連結至代理程式使用者。
  
  警告： 移除裝置時，請務必透過第三方應用程式 (而非 Google Home app (GHA)) 執行這項操作。如果應用程式中只有一個帳戶已連結的裝置，請勿移除該裝置，否則會導致同步處理錯誤。
3. 如果您使用 Scene 特徵，請選取「Test Scene」特徵。
  
  注意： 如果您想使用次要使用者驗證測試特徵，請在「測試設定」頁面中選取「啟用次要使用者驗證」選項。啟用這項設定後，如果裝置在測試期間回應挑戰，測試應用程式就會提示您。這個選項只會協助您完成自測。使用次要使用者驗證的裝置仍必須傳送給 Google 進行手動驗證。
4. 如果您要為 Local Home 裝置執行測試套件，請選取「支援 Local Home SDK」。
  1. 選取「店面商品目錄」或「無縫設定」。
  2. 如果裝置可以在本機處理 QUERY 意圖，請按一下「支援本機查詢」。
執行測試執行並查看結果：
1. 按一下「Next」即可開始執行測試。介面會顯示正在測試的裝置和特徵。
查看「結果與提交」頁面：
1. 測試完成後，請按一下「下一步」查看結果。

測試結果包含通過和失敗的測試次數，以及表示通過率的最終分數。

帳戶連結驗證測試

帳戶連結在 Google 智慧住宅生態系統中扮演重要角色。Test Suite 中的帳戶連結驗證測試會檢查 OAuth 服務是否有潛在問題。

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

存取權杖驗證測試

系統會測試從權杖交換端點傳回的存取權杖，確保其格式有效，並傳回有效的重新整理權杖。

測試項目	說明
檢查存取權杖是否為 JWT 格式	我們不建議使用 JWT 格式的存取權杖連結 Google 帳戶。如果找到 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 有效且已連結至您的服務。

錯誤訊息	解決方法
專案「<_id_>」先前未使用或已停用 HomeGraph API	確認已啟用 HomeGraph API。
找不到所要求的實體	確認 `agentUserId` 有效且已連結至您的服務。
請確認您在專案 `${your project id}` 中具備 `resourcemanager.projects.get` 權限，並已在同意畫面中授予所有權限。取得模組資料時發生錯誤：getModuleData 錯誤：針對 https://hometestsuiteproxy-pa.googleapis.com/v1/module:get 的 HTTP 失敗回應：403 OK 403	請按照「排解身分與存取權管理權限問題」中的操作說明，確認您的帳戶具有專案的 `resourcemanager.projects.get` 權限。前往「具有您帳戶存取權的應用程式」頁面，查看「智慧家庭測試套件」的以下權限：基本帳戶資訊查看您的主要 Google 帳戶電子郵件地址查看您的個人資訊，包括您已公開的任何個人資訊額外存取權使用 Assistant：從你的 Google 帳戶中存取各種資料檢查及控制 Home Graph 中的智慧住宅裝置如果您收到權限錯誤，請先移除存取權，然後在再次登入時，在同意聲明畫面中授予所有權限。

請確認您在專案 ${your project id} 中具備 resourcemanager.projects.get 權限，並已在同意畫面中授予所有權限。

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

請按照「排解身分與存取權管理權限問題」中的操作說明，確認您的帳戶具有專案的 resourcemanager.projects.get 權限。
前往「具有您帳戶存取權的應用程式」頁面，查看「智慧家庭測試套件」的以下權限：
- 基本帳戶資訊
  1. 查看您的主要 Google 帳戶電子郵件地址
  2. 查看您的個人資訊，包括您已公開的任何個人資訊
- 額外存取權
  1. 使用 Assistant：從你的 Google 帳戶中存取各種資料
  2. 檢查及控制 Home Graph 中的智慧住宅裝置
如果您收到權限錯誤，請先移除存取權，然後在再次登入時，在同意聲明畫面中授予所有權限。

提交測試結果

您必須先通過 100% 的測試，才能提交 Test Suite 結果以取得認證。如果您有任何需要手動測試的特徵，即使測試結果未達 100%，您仍應執行 Test Suite 工具並附加結果。

如要提交測試結果並認證 Cloud-to-cloud 整合，請按照下列步驟操作：

收到測試結果後，如果您已準備好認證 Cloud-to-cloud 整合作業，請按一下 Test Suite 工具中的「提交」。
依序前往「Google Home Developer Console」 >「Cloud-to-cloud」>「認證」。
選取要認證的整合項目。
在「說明文件」下方，輸入 Test Suite 結果 ID。
填寫所有必填欄位，然後按一下「提交」。

注意： 您提交的測試結果必須包含要求同步處理的測試結果。將測試結果提交給 Google 後，您需要將 Cloud-to-cloud 整合提交審查。