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

온도 조절기 API

Nest API는 EU의 Heat Link를 사용하는 Thermostat E를 제외한 모든 Nest Learning ThermostatTM 모델과 호환됩니다.

사용자는 그룹별 최댓값까지 여러 Nest Thermostat을 devices/thermostats 그룹에 추가할 수 있습니다. 이 데이터 위치를 호출할 때 Nest Thermostat 데이터(구조에 있는 기기의 데이터 값)에 액세스할 수 있습니다.

아래의 모든 값은 JSON 문서의 각 devices/thermostats/device_id 아래에 있습니다.

기기_ID

Nest Thermostat 고유 식별자

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/device_id
반환string
예: 'peyiJNo0IldT2YlIVtYaGQ'
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v1-v6
온도 조절기 읽기/쓰기 / v1-v6

locale

언어 및 지역 (또는 국가) 환경설정을 지정합니다.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/locale
반환string
예: 'en-GB', 'ko-KR', '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

구조체_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
예: 'Halway'
액세스읽기 전용
제공 지역:온도 조절기 읽기 / 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

Nest 서비스와의 마지막 상호작용의 타임스탬프(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

훌륭합니다.

시스템 냉각 기능 (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

냉방용 열 펌프가 있는 시스템의 응급 난방 상태입니다.

응급 난방이 켜져 있는 경우:

  • 사용자는 기기의 희망 온도를 조정할 수 있지만 응급 난방이 꺼질 때까지 모드를 변경할 수 없습니다.
  • API를 통해 hvac_mode을 계속 변경할 수 있습니다.

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와 함께 사용하여 미리 설정된 (사용자 지정) 기간 동안 팬을 켭니다.

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

세부정보
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
쓰기:
온도 조절기 읽기/write / v5-v6

목표_온도_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도로 표시됩니다. 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도로 표시됩니다. 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도 단위로 표시됩니다. 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도로 표시됩니다. 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도 단위로 표시됩니다. 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도 단위로 표시됩니다.

세부정보
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도로 표시됩니다.

세부정보
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_mode

난방 및 냉방 기능이 있는 시스템의 난방 또는 냉방 또는 에너지 절약을 위한 절전 온도와 같은 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

기기에서 측정된 온도 (화씨)입니다.

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

장소_ID

Nest의 고유한 생성 식별자로, 기기의 표시 이름인 name를 나타냅니다.

Nest Thermostat, Nest Protect, Nest Cam의 위치에 관해 자세히 알아보세요.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/where_id
반환string
예: 'd6reb_OZTM...'
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v4-v6
온도 조절기 읽기/쓰기 / v4-v6

잠겨 있음

온도 조절기 잠금 상태 true인 경우 온도 조절기 잠금 기능이 사용 설정되며 온도 범위를 최소/최대 값 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
값: true, false
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v5-v6
온도 조절기 읽기/쓰기 / v5-v6

lock_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

잠긴_시간_최대_값

최대 온도 조절기 온도가 1°F로 표시됩니다. is_lockedtrue인 경우에 사용됩니다.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
반환string
예: 80
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v5-v6
온도 조절기 읽기/쓰기 / v5-v6

lock_temp_min_c

최저 온도 조절기 온도가 섭씨 0.5°C로 표시됩니다. is_lockedtrue인 경우에 사용됩니다.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
반환string
예: 19.5
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v5-v6
온도 조절기 읽기/쓰기 / v5-v6

고정된_최대_최대_시간

최대 온도 조절기 온도가 섭씨 0.5°C로 표시됩니다. is_lockedtrue인 경우에 사용됩니다.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
반환string
예: 24.5
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v5-v6
온도 조절기 읽기/쓰기 / v5-v6

라벨

온도 조절기 맞춤 라벨 여기서 괄호의 이름 뒤에 표시됩니다.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/label
반환string
예: '위층', '게스트 룸', '놀이터'
액세스읽기/쓰기
제공 지역:읽기:
온도 조절기 읽기 / v6
온도 조절기 읽기/쓰기 / v6
쓰기:
온도 조절기 읽기/쓰기 / v5 -v6

un빛 보정_사용

직사광선 차단 사용 설정 상태입니다. sunlight_correction_active과 함께 사용됩니다. true인 경우 직사광선 차단 기술을 사용 설정하면 온도 조절기가 직사광선에 노출되도록 자동 조정하며 정확한 온도를 설정하고 설정합니다.

자세한 내용은 선블록이란?을 참고하세요.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
반환boolean
값: true, false
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v6
온도 조절기 읽기/쓰기 / v6

s빛_수정_활성

직사광선 차단 활성 상태입니다. sunlight_correction_enabled과 함께 사용됩니다. true인 경우 온도 조절기가 직사광선에 위치함을 나타냅니다.

자세한 내용은 선블록이란?을 참고하세요.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
반환boolean
값: true, false
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v6
온도 조절기 읽기/쓰기 / v6

장소_이름

기기의 표시 이름입니다. 온도 조절기 where_id와 연결됩니다. 제공된 목록의 방 이름 또는 커스텀 이름을 사용할 수 있습니다. Nest Thermostat, Nest Protect, Nest Cam의 위치에 관해 자세히 알아보세요.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/where_name
반환string
예: 'Halway'
액세스읽기 전용
제공 지역:온도 조절기 읽기 / 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

대상_학습_시간

학습 모드에서 Nest Thermostat은 HVAC 시스템을 학습하여 희망 온도에 도달하는 데 걸리는 시간을 파악합니다. 온도 조절기가 희망 온도에 도달하는 데 걸리는 시간을 합리적으로 예측할 수 있는 충분한 정보가 있으면 이 값은 training에서 ready로 변경됩니다.

자세한 내용은 온도 조절기를 참조하세요.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
반환string enum
값: '학습', '준비됨'
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v6
온도 조절기 읽기/쓰기 / v6

이전_hvac_mode

마지막으로 선택한 hvac_mode를 표시합니다. 펌웨어가 오래된 기기에서 hvac_mode = eco로 전환할 때 사용됩니다.

절전 모드와 절전 모드 이외의 절전 모드 전환에 관한 자세한 내용은 온도 조절기 가이드를 참조하세요.

세부정보
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
반환string
값: '난방', '냉방', '냉난방', '사용 안함', 공백 (값 없음)
액세스읽기 전용
제공 지역:온도 조절기 읽기 / v6
온도 조절기 읽기/쓰기 / v6