智慧型住宅測試套件是一個網路應用程式,可讓您自行測試智慧型住宅動作。測試套件會根據與您帳戶相關聯的裝置和特性,自動產生並執行測試案例。測試完成後,您可以查看測試結果或填寫提交表單,將測試結果提交給 Google。
測試套件執行的測試包括但不限於下列項目:
如要啟動測試套件工具,請點選下列按鈕:
自行測試動作
以下章節說明如何在裝置和智慧型住宅動作專案中執行測試套件。測試套件會要求您登入帳戶,以便檢查您 Home Graph 中的裝置,並直接將指令傳送至 Google 助理。
如要自行測試動作,請按照下列步驟操作:
- 在網路瀏覽器中開啟智慧型住宅測試套件。
使用右上角的按鈕登入 Google。
設定「Project Details」(專案詳細資料):
- 在「Project ID」(專案 ID) 欄位中,為智慧住宅動作輸入專案 ID。
- 點選「下一步」。
調整「Test Settings」(測試設定):
- 如要認證智慧住宅動作,請不要變更預設的「Report State/Request Sync Timeout」值。不過,當您進行測試時,如果代理程式花費較多時間將狀態回報至住家圖表,則可以變更逾時值。
如果要驗證您的智慧住宅動作,請務必啟用「Test Request Sync」選項;測試期間,系統會提示您新增、更新或移除裝置,並檢查 Home Graph 中的裝置清單是否有所變更。變更動作是透過所測試的整合作業執行。在測試狀態下的整合作業中,至少必須連接一個代理程式代理程式。
如果您使用的是場景特性,請選取 [測試場景特性]。
執行測試執行作業並查看結果:
- 點選 [下一步] 即可開始測試。介面會顯示正在測試的裝置和特性
查看「Results & Submission」頁面:
- 測試完成後,按一下 [下一步] 即可查看結果。
測試結果包含通過及未通過的測試數,以及表示票證百分比的最終分數。
帳戶連結驗證測試
帳戶連結在 Google 智慧型住宅生態系統中扮演重要角色。測試套件中的帳戶連結驗證測試會檢查您的 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 不正確的要求錯誤,以傳回無效的更新憑證要求。如果回應與「錯誤代碼或訊息」不符,這個測試案例就會失敗。詳情請參閱存取憑證的存取憑證重新整理頁面。 |
測試更新憑證後,存取憑證是否已更新。 | 應傳回新的存取憑證以回應更新憑證要求。如果您的伺服器提供相同的存取憑證,測試案例就會失敗。 |
請檢查未過期的存取憑證是否仍然有效。 | 系統會顯示存取憑證到期時間。 |
檢查更新憑證是否已在重新整理時進行輪替。 | 我們會檢查更新憑證要求是否在更新憑證要求後變更。如果重新整理憑證有異動,您的伺服器只有在使用新的重新整理憑證後,才將無效的舊憑證失效,以避免競爭狀況造成使用者的帳戶連結中斷。如果您在使用新憑證之前,就先撤銷舊的更新憑證,測試將會失敗。 |
錯誤訊息
下表列出一些您可能遇到的常見錯誤訊息,以及建議的解決方式。
錯誤訊息 | 如何解決 |
---|---|
「{0/}」專案未使用或停用 HomeGraph API; | 確認您已啟用 HomeGraph API。 |
找不到您要求的項目 | 請確認你的 agentUserId 有效且已連結至服務。 |
提交測試結果
您必須提交 100% 的測試套件結果,才能提交認證表單。如果您有任何需要手動測試的特性,即使尚未達到 100%,也應該執行測試套件工具並附加結果。
如要提交檢測結果並驗證智慧住宅動作,請按照下列步驟操作:
- 收到測試結果後,即可接受智慧型住宅動作認證,請在測試套件工具中按一下 [提交]。
- 點擊 [下載測試結果] 按鈕即可擷取測試結果。
- 按一下 [前往提交表單],將測試結果提交給 Google。
填妥所有必填欄位,然後按一下 [Submit] (提交)。