Google致力于提高黑人社区的种族平等。 怎么看。
此页面由 Cloud Translation API 翻译。
Switch to English

Nest API参考

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