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 ... |