Home API 會使用 OAuth 2.0 授予結構中裝置的存取權。OAuth 可讓使用者授權應用程式或服務,不必揭露登入憑證。
如果您已有經過驗證的 OAuth 用戶端 (例如來自已發布的應用程式),即可使用該用戶端測試 Home API,不必設定新的用戶端。詳情請參閱「如果您有現有的 OAuth 用戶端」。
簽署應用程式
首先,請在 Android Studio 中執行應用程式,產生偵錯憑證。在 Android Studio 中執行或偵錯應用程式時,系統會自動產生偵錯憑證,用於開發和偵錯。如需完整說明,請參閱「Android Studio:簽署偵錯版本」。
應用程式執行後:
將行動裝置連上本機。 「Android Studio」會依型號列出已連線的裝置。從清單中選取裝置,然後按一下「執行專案」。這會在行動裝置上建構及安裝範例應用程式。
如需更詳細的說明,請參閱 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 用戶端。
將行動裝置連線至本機,然後從清單中選取裝置,再次點選「Run project」即可執行專案。有關更詳細的說明,請參閱 Android 開發者網站上的 在硬體裝置上執行應用程式。
如果您有現有的 OAuth 用戶端
如果您已為發布的應用程式建立經過驗證的 OAuth 用戶端,即可使用現有的 OAuth 用戶端測試 Home API。
Google Home Developer Console測試和使用 Home API 無需註冊。 但是,即使您擁有來自其他整合的已驗證 OAuth 用戶端,您仍然需要獲得批准的 Developer Console 註冊才能發布您的應用程式。
請注意下列事項:
使用現有 OAuth 用戶端時,使用者人數上限為 100 人。如要瞭解如何新增測試使用者,請參閱「設定 OAuth 同意畫面。 除了 OAuth 驗證外,Google Home API 也設下限制,應用程式最多只能向 100 位使用者要求授權。完成 Developer Console 註冊後,這項限制就會解除。
Developer Console 註冊 準備透過 OAuth 限制裝置類型授權,並更新應用程式以使用 Home API 時,請傳送註冊資料以供核准。
對於仍在等待 OAuth 驗證的 Google Cloud 應用,使用者必須等到驗證完成後才能完成 OAuth 流程。嘗試授予權限時會失敗,並顯示下列錯誤訊息:
Access blocked: <Project Name> has not completed the Google verification process.