開始使用

這個 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 APIDevice Access Sandbox 服務條款,以及每個帳戶的一次性費用 (不可退款)。

您必須接受《服務條款》並支付註冊費,才能建立專案。這項政策適用於所有使用者,以及希望提供商業服務的使用者。

如果尚未註冊,請在 Device Access Console 中註冊:

前往 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 提供。您必須具備 Google Cloud 專案,才能啟用 API 並為支援的 Nest 裝置授權 Google 帳戶。

使用下方的「啟用 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. 在「憑證」頁面上取得 OAuth 2.0 用戶端 ID。

建立裝置存取專案

返回 Device Access 主控台。

  1. 在「Console」(主控台) 主畫面上,選取「Create project」(建立專案)
  2. 填寫建立程序的每個畫面:
    1. 請輸入專案名稱。
    2. 輸入您在設定 Google Cloud 時產生的 OAuth 2.0 用戶端 ID。如果您先前並未複製 OAuth 用戶端 ID,可以在先前下載的 credentials.json 檔案中找到它。
    3. 啟用或停用事件。事件會由 Google Cloud Pub/Sub 管理,並會為專案授權的所有裝置和結構提供非同步更新。如果需要事件,請選取「啟用」。如果無法確定,請選取「停用」。你之後隨時可以啟用這些設定。
  3. 完成後,專案就會以 UUID 格式指派專案 ID,例如 32c4c2bc-fe0d-461b-b51c-f3885afff2f0。記下這個 ID,用於所有 SDM API 呼叫。

這個專案 ID 用於 OAuth 和 API 呼叫。這個屬性僅供Device Access 專案使用,而且與 Google Cloud 專案 ID 無關。