结构API

用户可以添加最多三个结构，每个结构的多个设备。

下面所有的值下的每个发现structures/ structure_id的JSON文档英寸

结构标识

结构的 ID 号。当您调用此数据位置时，您可以访问此结构中的数据值。

细节
https://developer-api.nest.com/structures/ structure_id /structure_id
退货	string 示例：“VqFabWH21nw...”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6 烟+CO读/v1-v5 离开阅读/ v1-v2 远离读/写 / v1-v2 ETA 写入 / v1-v2 邮政编码读取/v2 摄像头读取 / v1-v3 相机读取 + 图像 / v1-v4 相机读/写 / v1-v3 相机读/写+图像/ v1-v4 能量读取/v2

恒温器

结构中的恒温器列表，按唯一设备标识符。这是一个包含结构中所有恒温器的 JSON 对象数组。

细节
https://developer-api.nest.com/structures/ structure_id /thermostats
退货	array 例如： [ "peyiJNo0IldT2YlIVtYaGQ",... ]
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6 烟+CO读/v1-v5 离开阅读/ v1-v2 远离读/写 / v1-v2 ETA 写入 / v1-v2 摄像头读取 / v2-v3 相机读取 + 图像 / v2-v4 相机读/写 / v2-v3 相机读/写 + 图像 / v2-v4

烟雾警报

结构中的烟雾 + CO 警报列表，按唯一设备标识符。这是一个 JSON 对象数组，包括结构中的所有烟雾 + CO 警报。

细节
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
退货	array 例如： [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写/v1-v6 烟+CO读/v1-v5 离开阅读/ v1-v2 远离读/写 / v1-v2 ETA 写入 / v1-v2 摄像头读取 / v2-v3 相机读取 + 图像 / v2-v4 相机读/写 / v2-v3 相机读/写 + 图像 / v2-v4

相机

结构中的摄像机列表，按唯一设备标识符。这是一个 JSON 对象数组，其中包含结构中的所有相机。

细节
https://developer-api.nest.com/structures/ structure_id /cameras
退货	array 例如： [ "awJo6rH...",... ]
使用权	只读
可在	恒温读取 / v4-v6 恒温器读/写 / v4-v6 烟+CO读/v4-v5 离开阅读/ v2 离开读/写/ v2 ETA 写入 / v2 摄像头读取 / v1-v3 相机读取 + 图像 / v1-v4 相机读/写 / v1-v3 相机读/写+图像/ v1-v4

离开

指示结构的占用状态。

结构具有相关的两种状态： home或away 。如果没有运动的房子是感应到，该结构将改变从home到away 。

细节
https://developer-api.nest.com/structures/ structure_id /away
退货	string 价值观：“家”，“离家”
使用权	读/写
可在	读： 恒温读取/v1-v6 恒温器读/写 / v1-v6 烟+CO读/v1-v5 离开阅读/ v1-v2 远离读/写 / v1-v2 ETA 写入 / v1-v2 写： 远离读/写 / v1-v2

名称

用户定义的结构显示名称。

细节
https://developer-api.nest.com/structures/ structure_id /name
退货	string 示例：“我的家”、“海滨别墅”、“山屋”
使用权	读/写
可在	读： 恒温读取/v1-v6 恒温器读/写 / v1-v6 烟+CO读/v1-v5 离开阅读/ v1-v2 远离读/写 / v1-v2 ETA 写入 / v1-v2 邮政编码读取/v2 摄像头读取 / v1-v3 相机读取 + 图像 / v1-v4 相机读/写 / v1-v3 相机读/写+图像/ v1-v4 能量读取/v2 结构读/写/ v1 写： 结构读/写/ v1

国家代码

国家代码，在ISO 3166α-2格式。

细节
https://developer-api.nest.com/structures/ structure_id /country_code
退货	string 示例：“美国”、“加拿大”、“英国”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6 烟+CO读/v1-v5 离开阅读/ v1-v2 远离读/写 / v1-v2 ETA 写入 / v1-v2

邮政编码

邮政编码或邮政编码，取决于国家/地区。

细节
https://developer-api.nest.com/structures/ structure_id /postal_code
退货	string 示例：“94304”、“94304-1027”、“EC1A 1BB”
使用权	只读
可在	邮政编码读取/v1-v2

peak_period_start_time

开始的时候能上班高峰时，在ISO 8601的格式。

细节
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
退货	string 示例：“2016-12-31T23:59:59.000Z”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6 能量读取 / v1-v2

peak_period_end_time

结束的时间精力上下班高峰时，在ISO 8601的格式。

细节
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
退货	string 示例：“2016-12-31T23:59:59.000Z”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6 能量读取 / v1-v2

时区

在结构时区，在IANA时区格式。

细节
https://developer-api.nest.com/structures/ structure_id /time_zone
退货	string 示例：“美国/洛杉矶”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6 烟+CO读/v1-v5 离开阅读/ v1-v2 离开读/写/ v2 ETA 写入 / v1-v2

埃塔

ETA（预计到达时间）是一个可以设置在结构上的对象。它用于让 Nest 知道用户预计会在特定时间回家。有关如何使ETA呼叫信息，请参阅客场指南。

细节
https://developer-api.nest.com/structures/ structure_id /eta
退货	object 例如：“myTripID1024”、“2014-10-31T22:42:00.000Z”、“2016-12-31T23:59:59.000Z”
参数	trip_id 标识行程的用户定义字符串 estimated_arrival_window_begin 在时间戳ISO 8601格式。 必须大于NOW 。 estimated_arrival_window_end 在时间戳ISO 8601格式。 必须大于estimated_arrival_window_begin 。
使用权	只写
可在	ETA 写入 / v1-v2

eta_begin

在到达的最早的预期时间时间戳ISO 8601的格式。用于触发动作或事件。

细节
https://developer-api.nest.com/structures/ structure_id /eta_begin
退货	string 示例：“2016-12-31T23:59:59.000Z”
使用权	只读
可在	ETA 读取 / v1

rhr_enrollment

尖峰时刻奖励报名状态。

细节
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
退货	boolean 值：真、假
使用权	只读
可在	能量读取 / v1-v2

wwn_security_state

结构安全状态。

细节
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
类型	string enum 值：“确定”，“阻止”
使用权	只读
可在	安全状态读取/v1

哪里

包含对象，其中标识符（ where_id和name ），用于在结构中的装置。 name是该设备的显示名称。它可以是我们提供的列表中的任何房间名称，也可以是自定义名称。

有关更多信息wheres ，看到的结构指南。

了解更多关于哪里的名字 鸟巢恒温器，巢保护和巢凸轮。

细节
https://developer-api.nest.com/structures/ structure_id /wheres
退货	object
使用权	只读
可在	读： 恒温读取 / v3-v6 恒温器读/写 / v3-v6 烟+CO读/v3-v5 摄像头读取 / v1-v3 相机读取 + 图像 / v1-v4 相机读/写 / v1-v3 相机读/写+图像/ v1-v4

where_id

一个唯一的，巢生成的标识符，代表name 。

where_id会自动创建并在呼叫过程中返回到创建name 。

细节
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
退货	string 示例：“Fqp6wJI...”
使用权	只读
可在	读： 恒温读取 / v3-v6 恒温器读/写 / v3-v6 烟+CO读/v3-v5 摄像头读取 / v1-v3 相机读取 + 图像 / v1-v4 相机读/写 / v1-v3 相机读/写+图像/ v1-v4

名称

设备的显示名称。

细节
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
退货	string 示例：“卧室”
使用权	读/写
可在	读： 恒温读取 / v3-v6 恒温器读/写 / v3-v6 烟+CO读/v3-v5 摄像头读取 / v1-v3 相机读取 + 图像 / v1-v4 相机读/写 / v1-v3 相机读/写+图像/ v1-v4

co_alarm_state

CO 报警状态。

细节
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
退货	string enum 值：“正常”、“警告”、“紧急情况”
使用权	只读
可在	烟+CO读/v5

烟雾警报状态

烟雾警报状态。

细节
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
退货	string enum 值：“正常”、“警告”、“紧急情况”
使用权	只读
可在	烟+CO读/v5