開始使用

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 控制台

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

啟用支援的裝置

Device Access 計畫支援以下裝置:

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

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

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

設定 Google Cloud Platform

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

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

  1. 如果您有想用於 Device Access的現有 Google 雲端專案,請務必先登入該專案的管理員帳戶。然後點選按鈕,從可用專案清單中選取現有專案。否則,請建立新專案。
  2. 系統詢問「你從哪裡撥打電話?」時,請選取「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 Enablement」(啟用 API) 頁面啟用 Smart Device Management API
  2. 在「憑證」頁面取得 OAuth 2.0 用戶端 ID。

建立裝置存取權限專案

返回 Device Access 控制台。

  1. 在管理中心主畫面中,選取「建立專案」
  2. 在建立過程中填寫每個畫面:
    1. 請輸入專案名稱。
    2. 輸入在設定 Google Cloud Platform 時產生的 OAuth 2.0 用戶端 ID。如果您先前未複製 OAuth 用戶端 ID,可以在下載的 credentials.json 檔案中找到。
    3. 啟用或停用事件。事件由 Google Cloud Pub/Sub 管理,可為專案授權的所有裝置和住家結構體提供非同步更新。如要啟用事件,請選取「啟用事件」,然後選取「建立專案」,並編輯 Pub/Sub 主題,提供主題 ID。如果不確定,請選取「停用」。您隨時可以啟用事件。
  3. 完成後,系統會為專案指派專案 ID,格式為 UUID,例如 32c4c2bc-fe0d-461b-b51c-f3885afff2f0。請記下這個 ID,您需要這個 ID 才能進行所有 SDM API 呼叫。

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