開始使用

Device Access 計畫可讓使用者使用 SDM API 存取、控制及管理 Google Nest 裝置。

如要開始使用 Device Access，請完成下列操作：

  1. 註冊 Device Access 計畫。
  2. 使用 Google 帳戶啟用支援的 Nest 裝置，
  3. 建立 Google Cloud 專案以啟用 SDM API 並取得 OAuth 2.0 用戶端 ID。
  4. 建立 Device Access 專案以接收專案 ID。

註冊裝置存取權

在建立第一個專案之前，您必須註冊 Device Access。註冊作業包括接受《Google API》和《裝置存取沙箱服務條款》，以及每個帳戶須支付的一次性費用 ($5 美元)。

您必須接受兩項《服務條款》並支付註冊費，才能建立專案。這項規定適用於所有使用者，包括個人和想要建立商業產品/服務的使用者。

如果您尚未註冊，請前往 Device Access 管理中心註冊：

前往 Device Access Console

詳情請參閱「Device Access Registration」一節。

啟用支援的裝置

Device Access 計畫支援下列裝置：

  • 所有 Google Nest Thermostat
  • 所有 Google Nest 攝影機
  • 所有 Google Nest Doorbell
  • Google Nest Hub Max

如需個別裝置型號的清單，請參閱「支援的裝置」頁面。

請參閱裝置使用手冊，瞭解如何啟用支援的裝置。

設定 Google Cloud Platform

SDM API 的存取權是透過 Google Cloud 提供。您必須擁有 Google Cloud 專案，才能啟用 API 並授權 Google 帳戶使用支援的 Nest 裝置。

使用下方的「啟用 API 並取得 OAuth 2.0 用戶端 ID」按鈕，啟用 Smart Device Management API 並取得 OAuth 2.0 用戶端 ID：

  1. 如果您已有要用於 Device Access的現有 Google Cloud 專案，請務必先登入該專案的管理員帳戶。然後點選按鈕，從可用專案清單中選取現有專案。否則，請建立新專案。
  2. 當系統詢問「您是從哪裡撥打電話？」時，選取「網路伺服器」。
  3. 輸入 https://www.google.com 做為「授權的重新導向 URI」的值。必須提供重新導向 URI，才能使用 PCM 取得授權碼。
  4. 設定完成後，請複製 OAuth 2.0 用戶端 ID 和用戶端密鑰值，並將憑證 JSON 下載至本機電腦。
啟用 API 並取得 OAuth 2.0 用戶端 ID

如要手動設定 Google Cloud 專案，或驗證設定並再次擷取憑證：

  1. 在「啟用 API」頁面中啟用 Smart Device Management API。
  2. 在「Credentials」(憑證) 頁面上取得 OAuth 2.0 用戶端 ID。

建立裝置存取權專案

返回 Device Access 控制台。

  1. 在主控台主畫面選取「 建立專案」。
  2. 填寫建立程序的各個畫面：
    1. 請輸入專案名稱。
    2. 輸入在設定 Google Cloud Platform 期間產生的 OAuth 2.0 用戶端 ID。如果您未事先複製 OAuth 用戶端 ID，則可在下載的 credentials.json 檔案中找到該 ID。
    3. 啟用或停用事件。事件由 Google Cloud Pub/Sub 管理，並為專案授權的所有裝置和結構提供非同步更新。如要查看事件，請選取「啟用」。如果您不確定，請選取「停用」。日後隨時可以啟用。
  3. 完成後，系統會為專案指派一個具有 UUID 的格式 (例如 32c4c2bc-fe0d-461b-b51c-f3885afff2f0) 的專案 ID。請記下這組 ID，所有 SDM API 呼叫都需要這個 ID。

這個專案 ID 會用於 OAuth 和 API 呼叫。專案專屬於您的Device Access 專案，與 Google Cloud 專案 ID 無關。

下一頁
2. 授權帳戶