Google 致力于为黑人社区推动种族平等。查看具体举措

嵌套 API 参考

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