Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
本頁面由 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 ...