Google致力於提高黑人社區的種族平等。 怎麼看。
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

Nest API參考

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

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

使用此交互式API參考探索數據模型。

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

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

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

  • 存在 (家庭和外出)
  • 安全 (煙和一氧化碳)
  • 一天中昂貴的時間使用能源
  • 事件 (聲音和動作)

但是,請記住,每個基於設備的對像都在實際約束下工作。例如,啟用緊急加熱後,恆溫器不應運行空調。我們的API旨在保護我們的設備和用戶的家,並防止某些意外或危險的動作。

權限和共享​​設備數據

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

有關更多信息,請參見“ 權限概述”

數據和隱私

家用產品涉及的數據可能非常個人化。家用傳感器數據包含有關人們如何在自己的個人空間中生活的信息。這些數據的安全性和處理非常重要,並且將重點放在Nest上。我們向用戶明確表明我們擁有什麼樣的數據,如何使用它們以及可以在哪裡控制它們。

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

元數據

元數據是調用根級終結點時提供的其他信息:

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

access_token

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

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

client_version

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

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

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

用戶身份

用戶ID可讓您跨API調用識別用戶。對於每個Works with Nest產品和用戶組合,此標識符都不同。

例如,如果用戶1授權了Nest產品A的Works和Nest產品B的Works,則產品A對用戶1具有一個user_id值,而產品B對用戶1具有不同的user_id值。

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