Google is committed to advancing racial equity for Black communities. See how.

嵌套 API 參考

Nest API 將物理房屋或建築物建模為結構,將 Nest Learning Thermostats、Nest Protects 和 Nest Cams 作為結構中的設備。此結構還包含有關整個家庭的信息(例如離開或 ETA 狀態,或活躍的高峰時間)。

結構中的每個數據元素都可以通過共享 JSON 文檔中的資源 URL(稱為“數據位置”)進行尋址。每個數據位置都可以存儲字符串、數字、布爾值、父/子對像或數組。

探索這個數據模型交互的API參考

通過 API,您可以從數據模型中多個級別的位置同步數據,例如:

  • 整個結構,包括所有設備
  • 結構中的單個設備
  • 一組數據值(當前和環境溫度)
  • 單個數據值(電池健康狀態)

您的產品應該對以下事件做出深思熟慮的響應:

  • 存在(主客場)
  • 安全(煙,一氧化碳)
  • 在一天的昂貴次使用
  • 事件(聲音和動作)

但是,請記住,每個基於設備的對像都在現實世界的約束下工作。例如,當啟用緊急加熱時,恆溫器不應運行空調。我們的 API 旨在保護我們的設備和用戶的家,並且會阻止某些令人驚訝或危險的行為。

權限和共享​​設備數據

讀取或寫入數據位置的能力由權限控制。權限組提供對設備和結構中選定數據值的讀、寫或讀/寫訪問。

欲了解更多信息,請參見權限概述

數據和隱私

與家居產品相關的數據可能非常個人化。家庭傳感器數據包含有關人們如何在個人空間中生活的信息。數據的安全性和處理非常重要,也是 Nest 的重點。我們讓用戶清楚地知道我們擁有什麼樣的數據、如何使用它以及他們可以在哪裡控制它。

詳細了解我們對隱私的看法

元數據

元數據是調用根級端點時提供的附加信息:

https://developer-api.nest.com/

訪問令牌

用戶授權後,您的產品使用訪問令牌對 Nest 服務進行 API 調用。此訪問令牌用作證明用戶已授權您的產品代表他們撥打電話的證據。

細節
退貨string
示例:“c.FmDPkzyzaQe...”

客戶端版本

客戶端版本是一個客戶端的最後一個用戶授權的版本,並與相關的access_token

當您更新客戶端的權限時,客戶端版本會增加,並且用戶會收到更新可用的通知。您的用戶必須先接受此客戶端更新,然後才能使用您更新的產品。

細節
退貨number
示例:1、17、42

用戶身份

用戶 ID 允許您通過 API 調用來識別用戶。此標識符因 Works with Nest 產品和用戶組合而異。

例如,如果用戶1已經授權與巢產品A和工作原理工作原理與巢產品B,則產品A具有一個user_id用於用戶1的值,和產品B具有不同user_id用於用戶1的值。

細節
退貨string
示例:z.1.1.7DHps...