開始使用

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》和《Device Access Sandbox 服務條款》，以及每個帳戶須支付一次性不可退還的費用 (5 美元)。

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

如果您尚未在 Device Access 控制台註冊，請按照下列步驟操作：

前往 Device Access 控制台

詳情請參閱「Device Access 註冊」。

啟用支援的裝置

Device Access 計畫支援下列裝置：

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

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

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

設定 Google Cloud Platform

SDM API 的存取權可透過 Google Cloud 取得。如要啟用 API 並授權 Google 帳戶使用支援的 Nest 裝置，您需要建立 Google Cloud 專案。

請使用下方的「Enable the API and get an OAuth 2.0 Client ID」按鈕，啟用 Smart Device Management API 並取得 OAuth 2.0 用戶端 ID：

  1. 如果您有要用於 Device Access的現有 Google Cloud 專案，請務必先登入該專案的管理員帳戶。然後按一下按鈕，從可用專案清單中選取現有專案。否則請建立新專案。
  2. 系統詢問「Where are you calling from?」時，請選取「Web Server」。
  3. 將 https://www.google.com 輸入「授權重新導向 URI」的值中。使用 PCM 取得授權碼時，必須提供重新導向 URI。
  4. 設定完成後，請複製 OAuth 2.0 用戶端 ID 和用戶端密鑰值，並將憑證 JSON 檔案下載到本機電腦。
啟用 API 並取得 OAuth 2.0 用戶端 ID

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

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

建立裝置存取專案

返回 Device Access 控制台。

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

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

下一頁
2. 授權帳戶