Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Termostat API

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

Użytkownicy mogą dodawać wiele termostatów Nest do grupy devices/thermostats , do maksymalnej liczby na strukturę . Wykonując połączenie z tą lokalizacją danych, można uzyskać dostęp do danych termostatu Nest (wartości danych dla urządzeń w strukturze).

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

identyfikator urzadzenia

Unikalny identyfikator termostatu Nest.

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

Niepowtarzalny 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

imię

Wyświetl nazwę urządzenia. Może to być dowolna nazwa pokoju z dostarczonej przez nas listy lub nazwa niestandardowa.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /name
Zwroty string
Przykład: „Przedpokój”
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. Obejmuje niestandardową (etykietę), utworzoną przez użytkownika lub przez wheres .

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

last_connection

Sygnatura czasowa ostatniej udanej interakcji z usługą Nest w formacie ISO 8601 .

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 (ma 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

can_heat

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 ustawić temperaturę docelową na urządzeniu, ale nie może zmienić trybu, dopóki ogrzewanie awaryjne nie zostanie wyłączone
  • Tryb hvac_mode można nadal zmienić za pośrednictwem interfejsu API

Zobacz, czym jest nagrzewanie awaryjne? aby uzyskać więcej informacji o tym, jak termostat Nest 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 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_active

Wskazuje, czy włączony jest zegar wentylatora; używany z fan_timer_duration do włączania wentylatora na (określony przez użytkownika) wstępnie ustawiony czas trwania.

Zobacz Zaawansowane sterowanie wentylatorem, aby uzyskać więcej informacji o tym, jak klienci ustawiają czas trwania 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

Znacznik czasu pokazujący, kiedy licznik czasu wentylatora osiągnie 0 (czas zatrzymania), w formacie ISO 8601 .

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

has_leaf

Wyświetlany, gdy termostat jest ustawiony na temperaturę oszczędzającą energię.

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

Fahrenheit lub Celsjusz; 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

temperatura_docelowa_f

Pożądana temperatura w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy 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

temperatura_docelowa_c

Pożądana temperatura w pół stopni Celsjusza (0,5 ° C). Używane, gdy 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

target_temperature_high_f

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

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

temperatura_docelowa_wysoka_c

Maksymalna temperatura docelowa wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy hvac_mode = heat-cool (tryb Heat • Cool).

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, gdy hvac_mode = heat-cool (tryb Heat • Cool).

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ół stopni Celsjusza (0,5 ° C). Używane, gdy hvac_mode = heat-cool (tryb Heat • Cool).

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

eco_temperature_high_f

Maksymalna temperatura ekonomiczna, wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy 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
Odczyt / zapis termostatu / v6

eco_temperature_high_c

Maksymalna temperatura eko, wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy 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
Odczyt / zapis termostatu / v6

eco_temperature_low_f

Minimalna temperatura ekonomiczna, wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy 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
Odczyt / zapis termostatu / v6

eco_temperature_low_c

Minimalna temperatura eko, wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy 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
Odczyt / zapis termostatu / v6

away_temperature_high_f (DEPRECATED)

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 (DEPRECATED)

Maksymalna temperatura poza domem, wyświetlana w pół stopni 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 (DEPRECATED)

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 (DEPRECATED)

Minimalna temperatura poza domem, wyświetlana w pół stopni 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

hvac_mode

Wskazuje tryby ogrzewania / chłodzenia systemu HVAC, takie jak Ogrzewanie • Chłodzenie dla systemów z wydajnością ogrzewania i chłodzenia lub Temperatury Eco 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

ambient_temperature_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ół stopni 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 formacie procentowym (%), zmierzona 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 Termostat odczyt / v2-v6
Termostat odczyt / zapis / v2-v6

hvac_state

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

Gdy jest off , system HVAC nie ogrzewa ani nie chłodzi aktywnie. hvac_state jest niezależne od pracy wentylatora.

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

gdzie_id

Unikalny, wygenerowany przez Nest identyfikator, który reprezentuje name , wyświetlaną nazwę urządzenia.

Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest .

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 prawda, funkcja blokady termostatu jest włączona i ogranicza zakres temperatur do następujących 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

Locked_temp_min_f

Minimalna temperatura blokady termostatu , wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy is_locked ma wartość 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

Locked_temp_max_f

Maksymalna temperatura blokady termostatu , wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy is_locked ma wartość 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

Locked_temp_min_c

Minimalna temperatura blokady termostatu , wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy is_locked ma wartość 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

Locked_temp_max_c

Maksymalna temperatura blokady termostatu , wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy is_locked ma wartość 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

Niestandardowa etykieta termostatu. Pojawia się w nawiasach, po nazwie miejsca.

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
Odczyt / zapis termostatu / v6
Pisać:
Termostat odczyt / zapis / v5-v6

sunlight_correction_enabled

Status włączonej blokady przeciwsłonecznej. Używany z sunlight_correction_active . Gdy true , technologia Sunblock jest włączona, a termostat automatycznie dostosowuje się do bezpośredniego światła słonecznego, odczytując i ustawiając prawidłową temperaturę.

Aby uzyskać więcej informacji, zobacz Co to jest krem ​​z filtrem przeciwsłonecznym?

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
Odczyt / zapis termostatu / v6

sunlight_correction_active

Status aktywnego kremu z filtrem. Używane z sunlight_correction_enabled . Jeśli true , oznacza, że ​​termostat znajduje się w bezpośrednim świetle słonecznym.

Aby uzyskać więcej informacji, zobacz Co to jest krem ​​z filtrem przeciwsłonecznym?

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
Odczyt / zapis termostatu / v6

gdzie_nazwa

Wyświetlana nazwa urządzenia. Powiązane z termostatem where_id . Może to być dowolna nazwa pokoju z dostarczonej przez nas listy lub nazwa niestandardowa. Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest .

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

fan_timer_duration

Określa czas (w minutach), w którym wentylator ma pracować.

Ustawienie fan_timer_active włącza wentylator. Wartość fan_timer_timeout wskazuje sygnaturę czasową, gdy fan_timer_duration jest ustawiona na koniec.

Aby dowiedzieć się, jak klienci ustawiają licznik czasu wentylatora, zobacz Czas trwania licznika .

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
Odczyt / zapis termostatu / v6
Pisać:
Odczyt / zapis termostatu / v6

time_to_target

Czas w minutach, w jakim konstrukcja osiągnie docelową temperaturę.

Aby uzyskać więcej informacji, patrz Czas do uzyskania temperatury .

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
Odczyt / zapis termostatu / v6

time_to_target_training

W trybie treningowym Nest Thermostat uczy się o systemie HVAC i odkrywa, ile czasu potrzeba, aby osiągnąć docelową temperaturę. Gdy termostat ma wystarczające informacje, aby dokonać rozsądnego oszacowania czasu do osiągnięcia temperatury docelowej, wartość ta zmieni się od training do ready .

Aby uzyskać więcej informacji, patrz Czas do uzyskania temperatury .

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
Odczyt / zapis termostatu / v6

previous_hvac_mode

Wyświetla ostatnio wybrany hvac_mode . Używany podczas przełączania z hvac_mode = eco na urządzeniu z przestarzałym oprogramowaniem.

Aby dowiedzieć się więcej o przełączaniu między trybami Eco i non-Eco, zobacz Przewodnik po termostacie .

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