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

恒温器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 = heatcool

细节
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 = heatcool

细节
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 温度用于节能。

细节
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_flocked_temp_max_flocked_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_lockedtrue

细节
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_lockedtrue

细节
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_lockedtrue

细节
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_lockedtrue

细节
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 系统并发现达到目标温度所需的时间。当温控器有足够的信息,以使达到目标温度的时间,合理估算,这个值将改变从trainingready

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

细节
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