恒温器API

Nest API 适用于所有 Nest Learning Thermostat™ 型号，但在欧盟带有 Heat Link 的 Thermostat E 除外。

用户可以添加多个巢恒温器到devices/thermostats组，直至每结构最大。当您调用此数据位置时，您可以访问 Nest Thermostat 数据（结构中设备的数据值）。

下面所有的值被每个下找到devices/thermostats/ device_id的JSON文档英寸

设备编号

Nest Thermostat 唯一标识符。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
退货	string 示例：“peyiJNo0IldT2YlIVtYaGQ”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

语言环境

指定语言和地区（或国家）首选项。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /locale
退货	string 示例：“en-GB”、“en-US”、“es-US”、“fr-CA”、“fr-CA”、“nl-NL”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

软件版本

软件版本。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
退货	string 示例：“4.0”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

结构标识

结构唯一标识符。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
退货	string 示例：“VqFabWH21nw...”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

名称

设备的显示名称。可以是我们提供的列表中的任何房间名称，也可以是自定义名称。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /name
退货	string 示例：“走廊”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

name_long

设备的长显示名称。包括，或者通过自定义（标记），由用户创建的wheres 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
退货	string 示例：“走廊恒温器（楼上）”
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

最后一个连接

与鸟巢服务的一次成功互动，在时间戳ISO 8601的格式。

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

在线

设备与 Nest 服务的连接状态。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
退货	boolean 值：真、假
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

can_cool

系统冷却能力（有交流电）。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
退货	boolean 值：真、假
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

can_heat

系统加热能力。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
退货	boolean 值：真、假
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

is_using_emergency_heat

带有用于冷却的热泵的系统中的紧急热状态。

当紧急加热开启时：

• 用户可以在设备上调整目标温度，但在紧急加热关闭之前无法更改模式
• 该hvac_mode仍然可以通过API来改变

见什么急热？了解有关 Nest Thermostat 如何支持紧急供暖的更多信息。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
退货	boolean 值：真、假
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

has_fan

系统能够独立于加热或冷却控制风扇。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
退货	boolean 值：真、假
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

fan_timer_active

指示风扇定时器是否已启用；与用于fan_timer_duration接通风扇为（用户指定的）预先设定的时间。

见先进的风机控制的客户如何设置风扇时间的详细信息。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
退货	boolean 值：真、假
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

fan_timer_timeout

时间戳示出当风扇定时器达到0（停止时间），在ISO 8601格式。

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

has_leaf

当恒温器设置为节能温度时显示。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
退货	boolean 值：真、假
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

温度标度

华氏或摄氏；配合温度显示使用。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
退货	string enum 值：“F”、“C”
使用权	读/写
可在	读： 恒温读取/v1-v6 恒温器读/写 / v1-v6 写： 恒温器读/写 / v5-v6

目标温度_f

所需温度，全华氏度 (1°F)。使用时hvac_mode = heat或cool 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
退货	number 示例：72
范围	50-90
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

目标温度_c

所需温度，以半摄氏度 (0.5°C) 为单位。使用时hvac_mode = heat或cool 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
退货	number 示例：21.5
范围	9-32
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

target_temperature_high_f

最高目标温度，以整华氏度 (1°F) 显示。使用时hvac_mode = heat-cool （热•冷色模式）。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
退货	number 示例：80
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

target_temperature_high_c

最高目标温度，以半摄氏度 (0.5°C) 显示。使用时hvac_mode = heat-cool （热•冷色模式）。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
退货	number 示例：24.5
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

target_temperature_low_f

最低目标温度，以整个华氏度 (1°F) 显示。使用时hvac_mode = heat-cool （热•冷色模式）。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
退货	number 示例：65
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

target_temperature_low_c

最低目标温度，以半摄氏度 (0.5°C) 显示。使用时hvac_mode = heat-cool （热•冷色模式）。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
退货	number 示例：19.5
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

eco_temperature_high_f

最高环保温度，以整个华氏度 (1°F) 显示。使用时hvac_mode = eco 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
退货	number 示例：80
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

eco_temperature_high_c

最高环保温度，以半摄氏度 (0.5°C) 显示。使用时hvac_mode = eco 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
退货	number 示例：24.5
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

eco_temperature_low_f

最低生态温度，以整个华氏度 (1°F) 显示。使用时hvac_mode = eco 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
退货	number 示例：65
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

eco_temperature_low_c

最低环保温度，以半摄氏度 (0.5°C) 显示。使用时hvac_mode = eco 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
退货	number 示例：19.5
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

away_temperature_high_f（已弃用）

最大客场温度，以整个华氏度 (1°F) 显示。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
退货	number 示例：80
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

away_temperature_high_c（已弃用）

最大客场温度，以半摄氏度 (0.5°C) 显示。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
退货	number 示例：24.5
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

away_temperature_low_f（已弃用）

最低客场温度，以整个华氏度 (1°F) 显示。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
退货	number 示例：65
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

away_temperature_low_c（已弃用）

最低客场温度，以半摄氏度 (0.5°C) 显示。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
退货	number 示例：19.5
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

暖通空调模式

指示 HVAC 系统加热/冷却模式，例如 Heat•Cool 用于具有加热和冷却能力的系统，或 Eco 温度用于节能。

• hvac_mode如果温控器可以改变锁定
• target_temperature_f和target_temperature_c如果不能改变hvac_mode = off或eco

细节
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
退货	string enum 值：“热”、“冷”、“热-冷”、“生态”、“关闭”
使用权	读/写
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

环境温度_f

在设备上测量的温度，单位为华氏度 (1°F)。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
退货	number 示例：72
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写 / v1-v6

环境温度_c

在设备上测量的温度，单位为半摄氏度 (0.5°C)。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
退货	number 示例：21.5
使用权	只读
可在	恒温读取/v1-v6 恒温器读/写/v1-v6

湿度

湿度，以百分比 (%) 格式，在设备上测量，四舍五入到最接近的 5%。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
退货	number 示例：35
范围	0-100
使用权	只读
可在	恒温读取 / v2-v6 恒温器读/写 / v2-v6

hvac_state

指示 HVAC 系统是主动加热、冷却还是关闭。使用此值指示 HVAC 活动状态。

时off ，HVAC系统没有被主动地加热或冷却。 hvac_state是独立风扇运转的。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
退货	string enum 值：“加热”、“冷却”、“关闭”
使用权	只读
可在	恒温读取 / v3-v6 恒温器读/写 / v3-v6

where_id

一个唯一的，巢生成的标识符，它表示name ，设备的显示名称。

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

细节
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
退货	string 示例：“d6reb_OZTM...”
使用权	只读
可在	恒温读取 / v4-v6 恒温器读/写 / v4-v6

被锁住了

恒温器锁定状态。为真时，该恒温器锁定功能被启用，并且限制的温度范围内对这些最小/最大值： locked_temp_min_f ， locked_temp_max_f ， locked_temp_min_c ，和locked_temp_max_c 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
退货	boolean 值：真、假
使用权	只读
可在	恒温读取 / v5-v6 恒温器读/写 / v5-v6

locked_temp_min_f

最小恒温锁温度，在整个华氏度（1°F）显示。当使用is_locked是true 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
退货	string 示例：65
使用权	只读
可在	恒温读取 / v5-v6 恒温器读/写 / v5-v6

locked_temp_max_f

最大恒温锁温度，在整个华氏度（1°F）显示。当使用is_locked是true 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
退货	string 示例：80
使用权	只读
可在	恒温读取 / v5-v6 恒温器读/写 / v5-v6

locked_temp_min_c

最小恒温锁温度，显示在半度显示摄氏度（0.5℃）。当使用is_locked是true 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
退货	string 示例：19.5
使用权	只读
可在	恒温读取 / v5-v6 恒温器读/写 / v5-v6

locked_temp_max_c

最大恒温锁温度，显示在半度显示摄氏度（0.5℃）。当使用is_locked是true 。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
退货	string 示例：24.5
使用权	只读
可在	恒温读取 / v5-v6 恒温器读/写 / v5-v6

标签

温控器自定义标签。出现在括号中，在 where 名称之后。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /label
退货	string 示例：“楼上”、“客房”、“游戏室”
使用权	读/写
可在	读： 温控器读取/v6 恒温器读/写/v6 写： 恒温器读/写 / v5-v6

sun_correction_enabled

防晒霜启用状态。使用sunlight_correction_active 。当true ，防晒技术被启用，且恒温自动调节阳光直射，阅读和设置正确的温度。

欲了解更多信息，请参阅什么是防晒？

细节
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
退货	boolean 值：真、假
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

sun_correction_active

防晒霜活动状态。使用sunlight_correction_enabled 。当true ，表明该温控器位于阳光直射。

欲了解更多信息，请参阅什么是防晒？

细节
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
退货	boolean 值：真、假
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

where_name

设备的显示名称。有关与恒温where_id 。可以是我们提供的列表中的任何房间名称，也可以是自定义名称。了解更多关于哪里的名字 鸟巢恒温器，巢保护和巢凸轮。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
退货	string 示例：“走廊”
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

fan_timer_duration

指定风扇设置运行的时间长度（以分钟为单位）。

该fan_timer_active设置打开风扇。所述fan_timer_timeout值表明时间戳fan_timer_duration被设置为结束。

要了解客户如何设置风扇计时器，看计时器时间。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
退货	int 值：15、30、45、60、120、240、480、720
使用权	读/写
可在	读： 温控器读取/v6 恒温器读/写/v6 写： 恒温器读/写/v6

时间到目标

结构达到目标温度所需的时间（以分钟为单位）。

见时间-温度以获取更多信息。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
退货	string enum 值：“~0”、“<5”、“~15”、“~90”、“120”
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

time_to_target_training

在训练模式下，Nest Thermostat 会了解 HVAC 系统并发现达到目标温度所需的时间。当温控器有足够的信息，以使达到目标温度的时间，合理估算，这个值将改变从training到ready 。

见时间-温度以获取更多信息。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
退货	string enum 值：“训练”、“准备”
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6

previous_hvac_mode

显示最后一次选择的hvac_mode 。从切换时使用hvac_mode = eco与过时的固件的设备上。

要了解更多关于悫生态和非生态模式之间切换，请参阅温控器指南。

细节
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
退货	string 值：“heat”、“cool”、“heat-cool”、“off”、空白（无值）
使用权	只读
可在	温控器读取/v6 恒温器读/写/v6