Notice: We're retiring Works with Nest. See the home page for more information.
Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 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文档。您的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的连接,请参阅授权概述