為 Android 應用程式設定 OAuth

Home API 會使用 OAuth 2.0 授予結構體中裝置的存取權。OAuth 可讓使用者授予應用程式或服務權限，而無須揭露登入憑證。

如果您已驗證 OAuth 用戶端 (例如已發布的應用程式)，可以使用該用戶端測試 Google Home API，無需設定新的用戶端。詳情請參閱「如果您已有 OAuth 用戶端」。

簽署應用程式

首先，請在 Android Studio 中執行應用程式，產生 OAuth 金鑰。在 Android Studio 中執行或偵錯應用程式時，系統會自動產生用於開發和偵錯的 OAuth 金鑰。如需完整說明，請參閱「Android Studio：為偵錯版本簽署」。

應用程式執行後：

  1. 將行動裝置連接至本機。Android Studio 會依型號列出已連結的裝置。從清單中選取裝置，然後按一下「執行專案」。這會在行動裝置上建構及安裝範例應用程式。

    如需更詳細的操作說明，請參閱 Android 開發人員網站上的「在硬體裝置上執行應用程式」。

  2. 停止執行中的應用程式。

  3. 請按照 Google Cloud 控制台說明網站上的「設定 OAuth 2.0 / 原生應用程式/Android」一文中詳細說明的步驟，取得 OAuth 憑證的 SHA-1 指紋。

  1. 在 Google Cloud 控制台中前往專案選取器資訊主頁，然後選取要用來建立 OAuth 憑證的專案。
  2. 前往「API 和服務」頁面，然後點選導覽選單中的「憑證」。

  3. 如果您尚未為這個 Google Cloud 專案設定同意畫面，系統會顯示「Configure consent screen」按鈕。在這種情況下，請按照下列程序設定同意畫面。否則，請繼續閱讀下一個部分。

    1. 按一下「設定同意畫面」。系統會顯示 OAuth 同意畫面頁面。
    2. 視用途而定，選取「內部」或「外部」，然後按一下「建立」。畫面上會顯示 OAuth 同意畫面窗格。
    3. 按照畫面上的指示，在「應用程式資訊」頁面輸入資訊，然後按一下「儲存並繼續」。系統會顯示「Scopes」窗格。
    4. 您不需要新增任何範圍，因此請按一下「儲存並繼續」。系統會顯示「Test users」窗格。
    5. 如果您想新增使用者，以便測試應用程式的存取權，請按一下「新增使用者」。系統隨即會顯示「新增使用者」窗格。測試使用者有權在您的應用程式中授予權限。
    6. 在空白欄位中新增一或多個 Google 帳戶電子郵件地址，然後按一下「新增」。
    7. 按一下「儲存並繼續」。系統會顯示「Summary」窗格。
    8. 查看 OAuth 同意畫面資訊，然後點選「返回資訊主頁」。

如需詳細資訊，請參閱 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 限制裝置類型授權，以便使用 Google Home API 更新應用程式時，請將註冊資訊送交審查。

如果 Google Cloud 應用程式仍在等待 OAuth 驗證，使用者必須等到驗證完成後，才能完成 OAuth 流程。授予權限的嘗試會失敗，並顯示以下錯誤：

Access blocked: <Project Name> has not completed the Google verification process.