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

结构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

离开

指示结构的占用状态。

结构具有相关的两种状态: homeaway 。如果没有运动的房子是感应到,该结构将改变从homeaway

细节
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_idname ),用于在结构中的装置。 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