Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

온도 조절기 API

Nest API는 EU의 Heat Link가있는 Thermostat E를 제외한 모든 Nest Learning Thermostat ™ 모델에서 작동합니다.

사용자는 여러 둥지 온도 조절 장치를 추가 할 수 있습니다 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

structure_id

구조 고유 식별자.

세부
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

last_connection

의 둥지 서비스를 마지막으로 성공한 상호 작용의 타임 스탬프 ISO 8601 형식입니다.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
보고 string
예 : "2016-12-31T23 : 59 : 59.000Z"
접속하다 읽기 전용
가능 온도 조절기 읽기 / v1-v6
온도 조절기 읽기 / 쓰기 / v1-v6

is_online

Nest 서비스와의 기기 연결 상태입니다.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / v1-v6
온도 조절기 읽기 / 쓰기 / v1-v6

can_cool

냉각 할 수있는 시스템 능력 (AC 있음).

세부
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / v1-v6
온도 조절기 읽기 / 쓰기 / v1-v6

can_heat

가열하는 시스템 능력.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / 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
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / v1-v6
온도 조절기 읽기 / 쓰기 / v1-v6

has_fan

가열 또는 냉각과 독립적으로 팬을 제어하는 ​​시스템 기능.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / v1-v6
온도 조절기 읽기 / 쓰기 / v1-v6

fan_timer_active

팬 타이머가 작동하는지 여부를 나타냅니다. 사용할 fan_timer_duration A (사용자 지정) 미리 설정된 기간 동안 상기 팬 켜.

참조 고급 팬 제어를 고객이 팬 기간을 설정하는 방법에 대한 자세한 내용은.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
보고 boolean
값 : true, false
접속하다 읽기 / 쓰기
가능 온도 조절기 읽기 / 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
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / 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도 (섭씨 0.5도)의 원하는 온도입니다. 때 사용 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

목표 _ 온도 _ 높은 _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도 (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도 (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도 (섭씨 0.5도)로 표시됩니다. 때 사용 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도 (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도 (섭씨 0.5도)로 표시됩니다.

세부
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도 (화씨 1도)로 표시됩니다.

세부
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도 (섭씨 0.5도)로 표시됩니다.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
보고 number
예 : 19.5
접속하다 읽기 전용
가능 온도 조절기 읽기 / v1-v6
온도 조절기 읽기 / 쓰기 / v1-v6

hvac_mode

난방 및 냉방 용량이있는 시스템의 경우 Heat • Cool, 에너지 절약을위한 Eco Temperatures와 같은 HVAC 시스템 난방 / 냉방 모드를 나타냅니다.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
보고 string enum
값 : "heat", "cool", "heat-cool", "eco", "off"
접속하다 읽기 / 쓰기
가능 온도 조절기 읽기 / v1-v6
온도 조절기 읽기 / 쓰기 / v1-v6

주변 _ 온도 _f

장치에서 측정 한 온도 (화씨 1도)입니다.

세부
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
값 : "heating", "cooling", "off"
접속하다 읽기 전용
가능 온도 조절기 읽기 / 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

is_locked

온도 조절기 잠금 상태. true 인 경우는 온도 조절기 잠금 기능이 설정,이 최소 / 최대 값으로 온도 범위에서 제한된다 locked_temp_min_f , locked_temp_max_f , locked_temp_min_clocked_temp_max_c .

세부
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / 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 ° C)로 표시. 때 사용 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 ° C)로 표시. 때 사용 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

sunlight_correction_enabled

썬 블록 활성화 상태. 함께 사용 sunlight_correction_active . 때 true , 썬 블록 기술이 활성화되며, 온도 조절기 자동, 직사광선에 조정 읽고 정확한 온도를 설정하는 것입니다.

더 많은 정보를 참조 썬 블록 무엇입니까?

세부
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / v6
온도 조절기 읽기 / 쓰기 / v6

sunlight_correction_active

썬 블록 활성 상태. 함께 사용 sunlight_correction_enabled . 때 true , 온도 조절기가 직사광선에 위치하고 있음을 나타냅니다.

더 많은 정보를 참조 썬 블록 무엇입니까?

세부
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 온도 조절기 읽기 / 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

time_to_target

구조물이 목표 온도에 도달하는 데 걸리는 시간 (분)입니다.

참조 타임 - 투 - 온도 자세한 내용은.

세부
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
값 : "training", "ready"
접속하다 읽기 전용
가능 온도 조절기 읽기 / 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