Nest API 将物理房屋或建筑物建模为结构，将 Nest Learning Thermostats、Nest Protects 和 Nest Cams 作为结构中的设备。此结构还包含有关整个家庭的信息（例如离开或 ETA 状态，或活跃的高峰时间）。
结构中的每个数据元素都可以通过共享 JSON 文档中的资源 URL（称为“数据位置”）寻址。每个数据位置都可以存储字符串、数字、布尔值、父/子对象或数组。
探索这个数据模型交互的API参考。
通过 API，您可以从数据模型中多个级别的位置同步数据，例如：
- 整个结构，包括所有设备
- 结构中的单个设备
- 一组数据值（当前和环境温度）
- 单个数据值（电池健康状态）
您的产品应该对以下事件做出深思熟虑的响应：
但是，请记住，每个基于设备的对象都在现实世界的约束下工作。例如，当启用紧急加热时，恒温器不应运行空调。我们的 API 旨在保护我们的设备和用户的家，并且会阻止某些令人惊讶或危险的行为。
权限和共享设备数据
读取或写入数据位置的能力由权限控制。权限组提供对设备和结构中选定数据值的读、写或读/写访问。
欲了解更多信息，请参见权限概述。
数据和隐私
与家居产品相关的数据可能非常个人化。家庭传感器数据包含有关人们如何在个人空间中生活的信息。数据的安全性和处理非常重要，也是 Nest 的重点。我们让用户清楚地知道我们拥有什么样的数据、如何使用它以及他们可以在哪里控制它。
详细了解我们对隐私的看法。
元数据
元数据是调用根级端点时提供的附加信息：
https://developer-api.nest.com/
访问令牌
用户授权后，您的产品使用访问令牌对 Nest 服务进行 API 调用。此访问令牌用作证明用户已授权您的产品代表他们拨打电话的证据。
| 细节 | |
|---|---|
| 退货 | string示例：“c.FmDPkzyzaQe...” |
客户端版本
客户端版本是一个客户端的最后一个用户授权的版本，并与相关的access_token 。
当您更新客户端的权限时，客户端版本会增加，并且用户会收到更新可用的通知。您的用户必须先接受此客户端更新，然后才能使用您更新的产品。
| 细节 | |
|---|---|
| 退货 | number示例：1、17、42 |
用户身份
用户 ID 允许您通过 API 调用来识别用户。此标识符因 Works with Nest 产品和用户组合而异。
例如，如果用户1已经授权与巢产品A和工作原理工作原理与巢产品B，则产品A具有一个user_id用于用户1的值，和产品B具有不同user_id用于用户1的值。
| 细节 | |
|---|---|
| 退货 | string示例：z.1.1.7DHps... |