Google is committed to advancing racial equity for Black communities. See how.

Termostat API

Nest API współpracuje ze wszystkimi modelami Nest Learning Thermostat™, z wyjątkiem Thermostat E z Heat Link w UE.

Użytkownicy mogą dodawać wiele termostaty Nest do devices/thermostats grupy, aż do maksymalnie jednej strukturze . Gdy dzwonisz do tej lokalizacji danych, możesz uzyskać dostęp do danych Nest Thermostat (wartości danych dla urządzeń w strukturze).

Wszystko poniżej wartości znajdują się pod każdym devices/thermostats/ device_id w dokumencie JSON.

identyfikator urzadzenia

Unikalny identyfikator Nest Thermostat.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Zwroty string
Przykład: „peyiJNo0IldT2YliVtYaGQ”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

widownia

Określa preferencje dotyczące języka i regionu (lub kraju).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Zwroty string
Przykłady: „en-GB”, „en-US”, „es-US”, „fr-CA”, „fr-CA”, „nl-NL”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

wersja oprogramowania

Wersja oprogramowania.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Zwroty string
Przykład: „4.0”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

identyfikator_struktury

Unikalny identyfikator struktury.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Zwroty string
Przykład: „VqFabWH21nw...”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

Nazwa

Wyświetlana nazwa urządzenia. Może to być dowolna nazwa pokoju z podanej przez nas listy lub nazwa niestandardowa.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /name
Zwroty string
Przykład: „Korytarz”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

name_long

Długa wyświetlana nazwa urządzenia. Zawiera niestandardowe (label), utworzonej przez użytkownika lub za pośrednictwem wheres .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Zwroty string
Przykład: „Termostat w przedpokoju (na górze)”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

ostatnie_połączenie

Znacznik czasu ostatniego udanego współdziałania z usługą gniazdo, w ISO 8601 formacie.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Zwroty string
Przykład: „2016-12-31T23:59:59.000Z”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

jest online

Stan połączenia urządzenia z usługą Nest.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

can_cool

Możliwość chłodzenia systemu (posiada AC).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

może_ogrzać

Zdolność systemu do ogrzewania.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

is_using_emergency_heat

Stan awaryjnego ogrzewania w systemach z pompami ciepła do chłodzenia.

Gdy ogrzewanie awaryjne jest włączone:

  • Użytkownik może dostosować docelową temperaturę na urządzeniu, ale nie może zmienić trybu, dopóki ogrzewanie awaryjne nie zostanie wyłączone
  • hvac_mode nadal można zmieniać za pomocą interfejsu API

Zobacz Co za awaryjny ciepła? aby uzyskać więcej informacji o tym, jak Nest Thermostat obsługuje ogrzewanie awaryjne.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

has_fan

Możliwość sterowania wentylatorem przez system niezależnie od grzania lub chłodzenia.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

fan_timer_aktywny

Wskazuje, czy zegar wentylatora jest włączony; stosować fan_timer_duration włączyć wentylator dla (określonej przez użytkownika) czas trwania zadanego.

Zobacz Zaawansowana kontrola wentylatora , aby uzyskać więcej informacji o tym, jak klienci ustawić czas wentylatora.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Zwroty boolean
Wartości: prawda, fałsz
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

fan_timer_timeout

Datownik pokazujący gdy timer wentylator osiągnie 0 (czas zatrzymania), w ISO 8601 formacie.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Zwroty string
Przykład: „2016-12-31T23:59:59.000Z”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

ma_liść

Wyświetlany, gdy termostat jest ustawiony na temperaturę oszczędzania energii.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

skala_temperatury

Fahrenheita lub Celsjusza; używany z wyświetlaczem temperatury.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Zwroty string enum
Wartości: „F”, „C”
Dostęp czytać/pisać
Dostępne w Czytać:
Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6
Pisać:
Termostat odczyt/zapis / v5-v6

docelowa_temperatura_f

Żądana temperatura w pełnych stopniach Fahrenheita (1°F). Używane przy hvac_mode = heat lub cool .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Zwroty number
Przykład: 72
Zasięg 50-90
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

docelowa_temperatura_c

Żądana temperatura, w pół stopniach Celsjusza (0,5°C). Używane przy hvac_mode = heat lub cool .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Zwroty number
Przykład: 21,5
Zasięg 9-32
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

docelowa_temperatura_wysoka_f

Maksymalna temperatura docelowa, wyświetlana w pełnych stopniach Fahrenheita (1°F). Używane przy hvac_mode = heat-cool (tryb super ciepła •).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Zwroty number
Przykład: 80
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

docelowa_temperatura_wysoka_c

Maksymalna temperatura docelowa, wyświetlana w pół stopniach Celsjusza (0,5°C). Używane przy hvac_mode = heat-cool (tryb super ciepła •).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Zwroty number
Przykład: 24,5
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

target_temperature_low_f

Minimalna temperatura docelowa, wyświetlana w pełnych stopniach Fahrenheita (1°F). Używane przy hvac_mode = heat-cool (tryb super ciepła •).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Zwroty number
Przykład: 65
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

target_temperature_low_c

Minimalna temperatura docelowa, wyświetlana w pół stopniach Celsjusza (0,5°C). Używane przy hvac_mode = heat-cool (tryb super ciepła •).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Zwroty number
Przykład: 19,5
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

eko_temperatura_wysoka_f

Maksymalna temperatura Eco, wyświetlana w pełnych stopniach Fahrenheita (1°F). Używane przy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Zwroty number
Przykład: 80
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

eko_temperatura_wysoka_c

Maksymalna temperatura Eco, wyświetlana w pół stopniach Celsjusza (0,5°C). Używane przy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Zwroty number
Przykład: 24,5
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

eko_temperatura_niska_f

Minimalna temperatura Eco, wyświetlana w pełnych stopniach Fahrenheita (1°F). Używane przy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Zwroty number
Przykład: 65
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

eko_temperatura_niska_c

Minimalna temperatura Eco, wyświetlana w pół stopniach Celsjusza (0,5°C). Używane przy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Zwroty number
Przykład: 19,5
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

away_temperature_high_f (WYCOFANE)

Maksymalna temperatura poza domem, wyświetlana w pełnych stopniach Fahrenheita (1°F).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Zwroty number
Przykład: 80
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

away_temperature_high_c (WYCOFANE)

Maksymalna temperatura poza domem, wyświetlana w pół stopniach Celsjusza (0,5°C).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Zwroty number
Przykład: 24,5
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

away_temperature_low_f (WYCOFANE)

Minimalna temperatura poza domem, wyświetlana w pełnych stopniach Fahrenheita (1°F).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Zwroty number
Przykład: 65
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

away_temperature_low_c (WYCOFANE)

Minimalna temperatura poza domem, wyświetlana w pół stopniach Celsjusza (0,5°C).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Zwroty number
Przykład: 19,5
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

tryb_hvac

Wskazuje tryby ogrzewania/chłodzenia systemu HVAC, takie jak Heat•Cool dla systemów z wydajnością ogrzewania i chłodzenia lub Eco Temperatures dla oszczędności energii.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Zwroty string enum
Wartości: „heat”, „cool”, „heat-cool”, „eco”, „off”
Dostęp czytać/pisać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

temperatura_otoczenia_f

Temperatura mierzona na urządzeniu w pełnych stopniach Fahrenheita (1°F).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Zwroty number
Przykład: 72
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

temperatura_otoczenia_c

Temperatura mierzona na urządzeniu w pół stopniach Celsjusza (0,5°C).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Zwroty number
Przykład: 21,5
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v1-v6
Termostat odczyt/zapis / v1-v6

wilgotność

Wilgotność, w procentach (%), mierzona na urządzeniu, zaokrąglona do najbliższych 5%.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Zwroty number
Przykład: 35
Zasięg 0-100
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v2-v6
Termostat odczyt/zapis / v2-v6

hvac_state

Wskazuje, czy system HVAC aktywnie nagrzewa, chłodzi, czy jest wyłączony. Użyj tej wartości, aby wskazać stan aktywności HVAC.

Gdy off system HVAC nie aktywnie do ogrzewania lub chłodzenia. hvac_state jest niezależne od działania wentylatora.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Zwroty string enum
Wartości: „ogrzewanie”, „chłodzenie”, „wyłączone”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v3-v6
Termostat odczyt/zapis / v3-v6

gdzie_id

Wyjątkowa, gniazdo generowane identyfikator stanowi name nazwa wyświetlania w urządzeniu.

Dowiedz się więcej o tym, gdzie nazwy Termostaty Nest ,Gniazdo Chroni i Nest kamery internetowe .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Zwroty string
Przykład: "d6reb_OZTM..."
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v4-v6
Termostat odczyt/zapis / v4-v6

jest zamknięte

Stan blokady termostatu. Gdy prawdziwy, termostat blokady funkcja ta jest włączona, i ogranicza zakres temperatur dla tych wartości min / max: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c i locked_temp_max_c .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v5-v6
Termostat odczyt/zapis / v5-v6

lock_temp_min_f

Minimalna blokady termostatem temperatury, wyświetlane w całych stopni Fahrenheita (1 ° F). Używane przy is_locked jest true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Zwroty string
Przykład: 65
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v5-v6
Termostat odczyt/zapis / v5-v6

lock_temp_max_f

Maksymalna termostatu blokady temperatura wyświetlane w całych stopni Fahrenheita (1 ° F). Używane przy is_locked jest true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Zwroty string
Przykład: 80
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v5-v6
Termostat odczyt/zapis / v5-v6

lock_temp_min_c

Minimalna blokady termostatem temperatury, wyświetlane w wyświetlanych na pół stopnia Celsjusza (0,5 ° C). Używane przy is_locked jest true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Zwroty string
Przykład: 19,5
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v5-v6
Termostat odczyt/zapis / v5-v6

lock_temp_max_c

Maksymalna termostatu blokady temperatura wyświetlane w wyświetlanych na pół stopnia Celsjusza (0,5 ° C). Używane przy is_locked jest true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Zwroty string
Przykład: 24,5
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v5-v6
Termostat odczyt/zapis / v5-v6

etykieta

Termostat niestandardowych etykiet . Pojawia się w nawiasach, po nazwie gdzie.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /label
Zwroty string
Przykłady: „Na piętrze”, „Pokój gościnny”, „Pokój zabaw”
Dostęp czytać/pisać
Dostępne w Czytać:
Odczyt termostatu / v6
Termostat odczyt/zapis / v6
Pisać:
Termostat odczyt/zapis / v5-v6

korekcja_słoneczna_włączona

Stan włączenia ochrony przeciwsłonecznej. Używany z sunlight_correction_active . Kiedy true , technologia Sunblock jest włączona, a termostat jest automatycznie dostosowując się do bezpośredniego światła słonecznego, czytanie i ustawienie odpowiedniej temperatury.

Aby uzyskać więcej informacji, zobacz Co to jest Sunblock?

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

korekcja_słoneczna_aktywna

Aktywny stan ochrony przeciwsłonecznej. Używany z sunlight_correction_enabled . Kiedy true , wskazuje, że termostat jest położony w bezpośrednim świetle słonecznym.

Aby uzyskać więcej informacji, zobacz Co to jest Sunblock?

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

gdzie_nazwa

Wyświetlana nazwa urządzenia. Związane z termostatem where_id . Może to być dowolna nazwa pokoju z podanej przez nas listy lub nazwa niestandardowa. Dowiedz się więcej o tym, gdzie nazwy Termostaty Nest ,Gniazdo Chroni i Nest kamery internetowe .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Zwroty string
Przykład: „Korytarz”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

fan_timer_duration

Określa czas (w minutach), przez jaki wentylator ma działać.

fan_timer_active ustawienie włącza się wentylator. fan_timer_timeout wartość wskazuje znacznik czasu kiedy fan_timer_duration jest ustawiony do końca.

Aby dowiedzieć się, w jaki sposób klienci ustawić timer wentylatora, patrz czasowe czas .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Zwroty int
Wartości: 15, 30, 45, 60, 120, 240, 480, 720
Dostęp czytać/pisać
Dostępne w Czytać:
Odczyt termostatu / v6
Termostat odczyt/zapis / v6
Pisać:
Termostat odczyt/zapis / v6

time_to_target

Czas w minutach, w którym konstrukcja osiągnie docelową temperaturę.

Zobacz czasu do temperatury , aby uzyskać więcej informacji.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Zwroty string enum
Wartości: "~0", "<5", "~15", "~90", "120"
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

time_to_target_training

W trybie treningowym Nest Thermostat poznaje system HVAC i wykrywa, ile czasu zajmuje osiągnięcie temperatury docelowej. Gdy termostat ma wystarczająco dużo informacji, aby podjąć rozsądną oszacowanie czasu do osiągnięcia temperatury docelowej, wartość ta zmienia się z training na ready .

Zobacz czasu do temperatury , aby uzyskać więcej informacji.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Zwroty string enum
Wartości: „trening”, „gotowy”
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6

previous_hvac_mode

Wyświetla ostatni wybrany hvac_mode . Wykorzystywane podczas przełączania z hvac_mode = eco na urządzeniu z przestarzałym oprogramowaniem.

Aby dowiedzieć się więcej na temat przełączania betwen Eco i Eco spoza trybach, zobacz Termostat Guide .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Zwroty string
Wartości: "heat", "cool", "heat-cool", "off", puste (brak wartości)
Dostęp tylko czytać
Dostępne w Odczyt termostatu / v6
Termostat odczyt/zapis / v6