Notice: We're retiring Works with Nest. See the home page for more information.
Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기
이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

서모 스탯 API

Nest API는 EU의 열 링크가있는 온도 조절기 E를 제외하고 모든 Nest Learning Thermostat ™ 모델과 작동합니다.

사용자는 여러 Nest 온도 조절기를 devices/thermostats 그룹에 최대 구조 당 최대 추가 할 수 있습니다. 이 데이터 위치를 호출하면 Nest 온도 조절기 데이터 (구조의 장치에 대한 데이터 값)에 액세스 할 수 있습니다.

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

장치 아이디

Nest 온도 조절기 고유 식별자.

세부
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
예 : "Hallway"
접속하다 읽기 전용
가능 서모 스탯 읽기 / V1-V6
서모 스탯 읽기 / 쓰기 / v1-v6

name_long

장치의 긴 표시 이름입니다. 사용자가 작성하거나 wheres 를 통해 사용자 정의 (라벨)를 포함합니다.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
보고 string
예 : "Hallway Thermostat (위층)"
접속하다 읽기 전용
가능 서모 스탯 읽기 / V1-V6
서모 스탯 읽기 / 쓰기 / v1-v6

last_connection

ISO 8601 형식의 Nest 서비스와의 마지막 성공적인 상호 작용의 타임 스탬프입니다.

세부
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
값 : 참, 거짓
접속하다 읽기 전용
가능 서모 스탯 읽기 / V1-V6
서모 스탯 읽기 / 쓰기 / v1-v6

can_cool

냉각하는 시스템 기능 (AC 있음)

세부
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
보고 boolean
값 : 참, 거짓
접속하다 읽기 전용
가능 서모 스탯 읽기 / V1-V6
서모 스탯 읽기 / 쓰기 / v1-v6

캔열

가열하는 시스템 능력.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
보고 boolean
값 : 참, 거짓
접속하다 읽기 전용
가능 서모 스탯 읽기 / V1-V6
서모 스탯 읽기 / 쓰기 / v1-v6

is_using_emergency_heat

냉각 용 히트 펌프가있는 시스템의 비상 열 상태.

비상 열이 켜져있는 경우 :

  • 사용자는 장치의 목표 온도를 조정할 수 있지만 비상 열이 꺼질 때까지 모드를 변경할 수 없습니다
  • hvac_mode 는 여전히 API를 통해 변경할 수 있습니다

비상 열이란 무엇입니까? Nest 온도 조절기가 비상 열을 지원하는 방법에 대한 자세한 내용은

세부
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도 (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 (DEPRECATED)

최대 화씨 온도, 화씨 (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 (DEPRECATED)

최대 섭씨 온도 (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 (DEPRECATED)

최소 화씨 온도, 화씨 (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_mode

가열 및 냉각 용량이있는 시스템의 Heat • Cool 또는 에너지 절약을위한 Eco Temperature와 같은 HVAC 시스템 가열 / 냉각 모드를 나타냅니다.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
보고 string enum
값 : "heat", "cool", "heat-cool", "eco", "off"
접속하다 읽기 / 쓰기
가능 서모 스탯 읽기 / V1-V6
서모 스탯 읽기 / 쓰기 / v1-v6

ambient_temperature_f

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

세부
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
보고 number
예 : 72
접속하다 읽기 전용
가능 서모 스탯 읽기 / V1-V6
서모 스탯 읽기 / 쓰기 / v1-v6

ambient_temperature_c

장치에서 측정 한 온도 (섭씨 0.5도)

세부
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 을 나타내는 고유 한 Nest 생성 식별자입니다.

Nest 온도 조절기 , Nest ProtectsNest Cam의 이름에 대해 자세히 알아보십시오.

세부
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
값 : 참, 거짓
접속하다 읽기 전용
가능 서모 스탯 읽기 / 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 ° C)로 표시됩니다. 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 ° 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

sunlight_correction_enabled

썬 블록 활성화 상태. sunlight_correction_active 와 함께 사용 sunlight_correction_active . true 경우 Sunblock 기술이 활성화되고 온도 조절기가 직사광선에 맞게 자동으로 조정되어 올바른 온도를 읽고 설정합니다.

자세한 내용 은 Sunblock이란?을 참조하십시오 .

세부
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
보고 boolean
값 : 참, 거짓
접속하다 읽기 전용
가능 서모 스탯 읽기 / V6
서모 스탯 읽기 / 쓰기 / v6

sunlight_correction_active

선 블록 활성 상태. sunlight_correction_enabled 와 함께 사용됩니다. true 인 경우 온도 조절기가 직사광선에 있음을 나타냅니다.

자세한 내용 은 Sunblock이란 무엇입니까?를 참조하십시오 .

세부
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
보고 boolean
값 : 참, 거짓
접속하다 읽기 전용
가능 서모 스탯 읽기 / V6
서모 스탯 읽기 / 쓰기 / v6

where_name

장치의 표시 이름입니다. 온도 조절기 where_id 와 연관됩니다. 우리가 제공하는 목록의 모든 객실 이름 또는 사용자 정의 이름이 될 수 있습니다. Nest 온도 조절기 , Nest ProtectsNest Cam의 이름에 대해 자세히 알아보십시오.

세부
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
보고 string
예 : "Hallway"
접속하다 읽기 전용
가능 서모 스탯 읽기 / V6
서모 스탯 읽기 / 쓰기 / v6

fan_timer_duration

팬이 실행되도록 설정된 시간 (분)을 지정합니다.

fan_timer_active 설정은 팬을 켭니다. fan_timer_timeout 값은 fan_timer_duration 이 종료되도록 설정된 경우 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 온도 조절기는 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