Device Access 計畫可讓使用者透過 SDM API 存取、控制及管理 Google Nest 裝置。
如要開始使用 Device Access,請完成下列工作:
- 註冊 Device Access 計畫。
- 使用 Google 帳戶啟用支援的 Nest 裝置。
- 建立 Google Cloud 專案,啟用 SDM API 並取得 OAuth 2.0 用戶端 ID。
- 建立 Device Access 專案,取得專案 ID。
註冊裝置存取權限
建立第一個專案前,請先註冊 Device Access。註冊時須接受《Google API》和《裝置存取權沙箱服務條款》,並為每個帳戶支付一次性費用 (不予退款),金額為$5 美元。
您必須接受《服務條款》並支付註冊費用,才能建立專案。這項規定適用於所有使用者,包括個人使用者和有意建立商業產品的使用者。
如果尚未註冊,請在 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:
- 如果您有想用於 Device Access的現有 Google Cloud 雲端專案,請務必先登入該專案的管理員帳戶。然後按一下按鈕,從可用專案清單中選取現有專案。否則請建立新專案。
- 系統詢問「你從何處撥打電話?」時,請選取「Web Server」。
- 在「Authorized redirect URIs」(授權重新導向 URI) 中輸入 https://www.google.com。如要使用 PCM 取得授權碼,必須提供重新導向 URI。
- 設定完成後,複製 OAuth 2.0 用戶端 ID 和用戶端密鑰值,並將憑證 JSON 檔案下載到本機。
如要手動設定 Google Cloud 雲端專案,或驗證設定並再次擷取憑證,請按照下列步驟操作:
建立裝置存取權限專案
返回 Device Access 控制台。
- 在管理中心主畫面中,選取「建立專案」。
- 在建立過程中填寫每個畫面:
- 請輸入專案名稱。
- 輸入在設定 Google Cloud Platform 時產生的 OAuth 2.0 用戶端 ID。如果您先前未複製 OAuth 用戶端 ID,可以在下載的
credentials.json檔案中找到。 - 啟用或停用事件。事件由 Google Cloud Pub/Sub 管理,可為專案授權的所有裝置和住家結構體提供非同步更新。如要使用事件,請選取「啟用事件」,然後選取「建立專案」,接著編輯 Pub/Sub 主題並提供主題 ID。如果不確定,請選取「停用」。 之後隨時可以啟用。
- 完成後,系統會為專案指派專案 ID,格式為 UUID,例如
32c4c2bc-fe0d-461b-b51c-f3885afff2f0。請記下這個 ID,您需要這個 ID 才能進行所有 SDM API 呼叫。
這個專案 ID 會用於 OAuth 和 API 呼叫。這項 ID 專屬於您的Device Access 專案,與 Google Cloud 專案 ID 無關。