智慧住宅 API 會使用 OAuth 2.0 授權存取結構中的裝置。OAuth 可讓使用者授權應用程式或服務,不必揭露登入憑證。
如果您已有經過驗證的 OAuth 用戶端 (例如來自已發布的應用程式),可以使用該用戶端測試 Home API,不必設定新的用戶端。詳情請參閱「如果您有現有的 OAuth 用戶端」。
簽署應用程式
首先,請在 Android Studio 中執行應用程式,產生偵錯憑證。在 Android Studio 中執行或偵錯應用程式時,系統會自動產生偵錯憑證,用於開發和偵錯。如需完整說明,請參閱「Android Studio:簽署偵錯版本」。
應用程式執行後:
將行動裝置連線至本機電腦。Android Studio 會依型號列出已連線的裝置。從清單中選取裝置,然後按一下「Run project」(執行專案)。這會在行動裝置上建構及安裝範例應用程式。
如需更詳細的說明,請參閱 Android 開發人員網站上的「在硬體裝置上執行應用程式」。
停止執行中的應用程式。
按照 Google Cloud 控制台說明網站上「設定 OAuth 2.0 / 原生應用程式 / Android」一文中的詳細說明,取得偵錯憑證的 SHA-1 指紋。
設定 OAuth 同意畫面
- 在 Google Cloud 控制台中,前往專案選取器資訊主頁,然後選取要用來建立 OAuth 憑證的專案。
- 前往「API 和服務」頁面,然後按一下導覽選單中的「憑證」。
如果您尚未為這個 Google Cloud 專案設定同意畫面,系統會顯示「設定同意畫面」按鈕。在這種情況下,請按照下列程序設定同意畫面。否則,請繼續下一個章節。
- 按一下「設定同意畫面」,系統會顯示「OAuth 同意畫面」頁面。
- 視用途選取「內部」或「外部」,然後按一下「建立」。「OAuth 同意畫面」窗格隨即顯示。
- 按照畫面上的指示,在「應用程式資訊」頁面輸入資訊,然後按一下「儲存並繼續」。系統會顯示「範圍」窗格。
- 您不需要新增任何範圍,因此請按一下「儲存並繼續」。系統會顯示「測試使用者」窗格。
- 按一下「目標對象」,然後點選「+ 新增使用者」按鈕。
- 輸入測試使用者的電子郵件地址,然後按一下「儲存」按鈕。
- 按一下「儲存並繼續」。系統會顯示「摘要」窗格。
- 檢查 OAuth 同意畫面資訊,然後按一下「Back to dashboard」(返回資訊主頁)。
如需完整詳細資料,請參閱 Google Cloud 控制台說明網站上的「設定 OAuth 同意畫面」。
註冊應用程式並建立憑證
如要註冊應用程式以使用 OAuth 2.0,並建立 OAuth 憑證,請按照「設定 OAuth 2.0」一文中的操作說明進行。您必須指出應用程式類型,即原生/Android 應用程式。
按照 Google Cloud 控制台說明網站上的「設定 OAuth 2.0 / 原生應用程式」一文中的指示,將簽署應用程式取得的 SHA-1 指紋,新增至您在 Google Cloud 控制台設定的 OAuth 用戶端。
將行動裝置連線至本機後,從清單中選取裝置,然後再次點選「執行專案」即可執行專案。如需更詳細的說明,請參閱 Android 開發人員網站上的「在硬體裝置上執行應用程式」。
如果您有現有的 OAuth 用戶端
如果您已為發布的應用程式建立經過驗證的 OAuth 用戶端,可以使用現有的 OAuth 用戶端測試 Home API。
測試及使用 Home API 時,不需要進行Google Home Developer Console註冊。不過,即使您有來自其他整合服務的已驗證 OAuth 用戶端,仍須通過Developer Console註冊程序,才能發布應用程式。
注意事項如下:
使用現有 OAuth 用戶端時,使用者人數上限為 100 人。如要瞭解如何新增測試使用者,請參閱「設定 OAuth 同意畫面」。無論是否通過 OAuth 驗證,Home API 都會限制應用程式可授予權限的使用者人數,上限為 100 人。完成Developer Console註冊後,這項限制就會解除。
Developer Console 註冊 準備透過 OAuth 限制裝置類型授權,並更新應用程式以使用 Home API 時,應送交審核。
對於Google Cloud仍待 OAuth 驗證的應用程式,使用者必須完成驗證才能完成 OAuth 流程。嘗試授予權限時會失敗,並顯示下列錯誤訊息:
Access blocked: <Project Name> has not completed the Google verification process.