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服務

Nest應用程序使用戶無論身在何處都可以與家連接。所有Nest設備(Thermostats,Protect和相機)和應用程序(iOS,Android和Web應用程序)都連接到Nest服務。

示例雲到雲

Nest服務提供房屋的數據模型。設備和應用程序將從此數據模型讀取以採取適當的措施。他們更新數據模型以反映系統中的更改。

例如,恆溫器從數據模型讀取其目標溫度。它將環境溫度設置為其當前測量值,並將傳感器數據發送到Home / Away Assist,它相應地調整結構模式。

嵌套設備在受限的環境中運行。功率有限,家庭網絡連接可能不可靠。您的產品和服務可以利用我們的設備算法為用戶提供簡單,直觀的家庭體驗。

數據模型

Nest API被表示為具有metadatadevicesstructures頂級屬性的JSON文檔。您的Works with Nest產品使用此JSON文檔與Nest設備和相關狀態更改進行交互並作出反應。

巢狀structures代表現實世界中的物理結構。它們充當devices的組織點,並存儲整個建築物的數據。通常, structure是用戶家。

嵌套devices代表結構中的物理設備(恆溫器,保護器和相機)。

JSON文檔中的每個數據元素均可通過URL(也稱為“數據位置”)進行尋址。與Nest產品配合使用時,可以讀取和寫入本文檔的各個部分並訂閱更改。此訂閱功能使Works with Nest產品可以實時對系統所做的更改做出反應,例如,當用戶將結構設置為“離開”時關閉燈。

對像也可以在真實世界的約束下工作。數據模型通過防止意外的危險動作來保護設備和用戶的家。例如,啟用緊急加熱後,恆溫器不會運行空調。

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

預期狀態

Nest服務存儲系統的權威狀態,並且與Nest產品一起使用可訂閱更改。修改此狀態(例如,更改恆溫器的目標溫度)會使服務將更改通知推送給所有訂戶。

由於此傳播存在一定的延遲,並且網絡可能不可靠,因此某個產品觀察到的狀態可能不是其他產品或服務當前觀察到的狀態。隨著消息在各種產品之間傳輸,狀態最終會同步。

這種面向文檔的發布/訂閱模型提供了響應性的應用程序交互。

使用Nest服務

要訪問Nest服務中的REST端點,請在產品中使用HTTPS。有許多第三方客戶端庫可用於此目的。

權限和授權

我們希望允許開發人員在不損害用戶隱私和安全性的情況下,開發能夠使住房更好的產品和服務。我們所有的通信都是安全的,並且訪問數據的權限始終由用戶明確授予。有關更多信息,請參見“ 權限概述”

授權由OAuth 2.0協議處理。當用戶同意提供對請求的權限級別的訪問時,Nest會對請求進行身份驗證,然後將訪問令牌授予請求者。該訪問令牌可用於訪問Nest API並與用戶的結構和設備進行交互。

授予訪問令牌會在用戶,Works with Nest產品和Nest之間建立信任關係。用戶可以隨時撤消訪問權限。

要了解如何授權與Nest API的連接,請參閱授權概述