Thermostat-API

Die Nest API funktioniert mit allen Nest Learning Thermostat™-Modellen, mit Ausnahme von Thermostat E mit Heat Link in der EU.

Benutzer können mehr Nest Thermostate zum hinzufügen devices/thermostats Gruppe, bis zum Maximum pro Struktur . Wenn Sie diesen Datenstandort anrufen, können Sie auf Nest Thermostat-Daten (Datenwerte für Geräte in der Struktur) zugreifen.

Die folgenden Werte Alle sind unter jedem gefundenen devices/thermostats/ device_id im JSON - Dokument.

Geräte ID

Eindeutige Kennung von Nest Thermostat.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Kehrt zurück	string Beispiel: "peyiJNo0IldT2YlIVtYaGQ"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Gebietsschema

Gibt die bevorzugte Sprache und Region (oder das Land) an.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Kehrt zurück	string Beispiele: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Softwareversion

Softwareversion.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Kehrt zurück	string Beispiel: "4.0"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Struktur_id

Eindeutige Kennung der Struktur.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Kehrt zurück	string Beispiel: "VqFabWH21nw..."
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Name

Anzeigename des Geräts. Kann ein beliebiger Raumname aus einer von uns bereitgestellten Liste oder ein benutzerdefinierter Name sein.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /name
Kehrt zurück	string Beispiel: "Flur"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

name_long

Langer Anzeigename des Geräts. Enthält ein benutzerdefiniertes (Etikett), vom Benutzer erstellt oder über wheres .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Kehrt zurück	string Beispiel: "Flurthermostat (oben)"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

letzte_Verbindung

Zeitstempel der letzten erfolgreichen Interaktion mit dem Nest Service, in ISO 8601 - Format.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Kehrt zurück	string Beispiel: "2016-12-31T23:59:59.000Z"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

ist online

Geräteverbindungsstatus mit dem Nest-Dienst.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

kann_cool

System Fähigkeit zu kühlen (hat AC).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

can_heat

Systemfähigkeit zu heizen.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

is_using_emergency_heat

Notwärmestatus in Systemen mit Wärmepumpen zum Kühlen.

Wenn die Notheizung eingeschaltet ist:

• Der Benutzer kann die Zieltemperatur am Gerät einstellen, aber den Modus nicht ändern, bis Emergency Heat ausgeschaltet ist
• Die hvac_mode kann immer noch über die API geändert werden

Siehe Was ist Notheizung? Weitere Informationen dazu, wie Nest Thermostat Notwärme unterstützt.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

has_fan

Systemfähigkeit, den Ventilator unabhängig vom Heizen oder Kühlen zu steuern.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

fan_timer_active

Zeigt an, ob der Lüfter-Timer aktiviert ist; mit verwendet fan_timer_duration für eine ( vom Benutzer festgelegten) voreingestellte Dauer am Ventilator einzuschalten.

Siehe Erweiterte Lüftersteuerung für weitere Informationen, wie Kunden Fan Dauer eingestellt.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

fan_timer_timeout

Zeitstempel zeigt , wenn der Lüfter Timer 0 (Stoppzeit) erreicht, in ISO 8601 - Format.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Kehrt zurück	string Beispiel: "2016-12-31T23:59:59.000Z"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

has_leaf

Wird angezeigt, wenn der Thermostat auf eine Energiespartemperatur eingestellt ist.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Temperaturskala

Fahrenheit oder Celsius; mit Temperaturanzeige verwendet.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Kehrt zurück	string enum Werte: "F", "C"
Zugriff	lesen Schreiben
Verfügbar in	Lesen: Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6 Schreiben: Thermostat lesen/schreiben / v5-v6

Zieltemperatur_f

Gewünschte Temperatur in vollen Grad Fahrenheit (1°F). Wird verwendet , wenn hvac_mode = heat oder cool .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Kehrt zurück	number Beispiel: 72
Reichweite	50-90
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

target_temperatur_c

Gewünschte Temperatur, in halben Grad Celsius (0,5°C). Wird verwendet , wenn hvac_mode = heat oder cool .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Kehrt zurück	number Beispiel: 21,5
Reichweite	9-32
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

target_temperature_high_f

Maximale Zieltemperatur, angezeigt in ganzen Grad Fahrenheit (1°F). Wird verwendet , wenn hvac_mode = heat-cool (Heat • Cool - Modus).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Kehrt zurück	number Beispiel: 80
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

target_temperature_high_c

Maximale Zieltemperatur, angezeigt in halben Grad Celsius (0,5°C). Wird verwendet , wenn hvac_mode = heat-cool (Heat • Cool - Modus).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Kehrt zurück	number Beispiel: 24,5
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

target_temperature_low_f

Minimale Zieltemperatur, angezeigt in ganzen Grad Fahrenheit (1°F). Wird verwendet , wenn hvac_mode = heat-cool (Heat • Cool - Modus).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Kehrt zurück	number Beispiel: 65
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

target_temperature_low_c

Minimale Zieltemperatur, angezeigt in halben Grad Celsius (0,5°C). Wird verwendet , wenn hvac_mode = heat-cool (Heat • Cool - Modus).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Kehrt zurück	number Beispiel: 19,5
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

eco_temperature_high_f

Maximale Eco-Temperatur, angezeigt in ganzen Grad Fahrenheit (1°F). Wird verwendet , wenn hvac_mode = eco .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Kehrt zurück	number Beispiel: 80
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

eco_temperature_high_c

Maximale Eco-Temperatur, angezeigt in halben Grad Celsius (0,5°C). Wird verwendet , wenn hvac_mode = eco .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Kehrt zurück	number Beispiel: 24,5
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

eco_temperature_low_f

Minimale Eco-Temperatur, angezeigt in ganzen Grad Fahrenheit (1°F). Wird verwendet , wenn hvac_mode = eco .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Kehrt zurück	number Beispiel: 65
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

eco_temperature_low_c

Minimale Eco-Temperatur, angezeigt in halben Grad Celsius (0,5°C). Wird verwendet , wenn hvac_mode = eco .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Kehrt zurück	number Beispiel: 19,5
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

away_temperature_high_f (VERALTET)

Maximale Abwesenheitstemperatur, angezeigt in ganzen Grad Fahrenheit (1°F).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Kehrt zurück	number Beispiel: 80
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

away_temperature_high_c (VERALTET)

Maximale Abwesenheitstemperatur, angezeigt in halben Grad Celsius (0,5°C).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Kehrt zurück	number Beispiel: 24,5
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

away_temperature_low_f (VERALTET)

Minimale Abwesenheitstemperatur, angezeigt in ganzen Grad Fahrenheit (1°F).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Kehrt zurück	number Beispiel: 65
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

away_temperature_low_c (VERALTET)

Minimale Abwesenheitstemperatur, angezeigt in halben Grad Celsius (0,5°C).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Kehrt zurück	number Beispiel: 19,5
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

hvac_mode

Zeigt Heiz-/Kühlmodi des HLK-Systems an, wie Heat•Cool für Systeme mit Heiz- und Kühlkapazität oder Eco-Temperaturen für Energieeinsparungen.

• hvac_mode kann geändert werden , wenn der Thermostat gesperrt
• target_temperature_f und target_temperature_c kann nicht geändert werden , wenn hvac_mode = off oder eco

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Kehrt zurück	string enum Werte: „heat“, „cool“, „heat-cool“, „eco“, „off“
Zugriff	lesen Schreiben
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Umgebungstemperatur_f

Temperatur, gemessen am Gerät, in ganzen Grad Fahrenheit (1°F).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Kehrt zurück	number Beispiel: 72
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Umgebungstemperatur_c

Temperatur, gemessen am Gerät, in halben Grad Celsius (0,5°C).

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Kehrt zurück	number Beispiel: 21,5
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

Feuchtigkeit

Luftfeuchtigkeit im Prozent (%) Format, gemessen am Gerät, auf die nächsten 5 % gerundet.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Kehrt zurück	number Beispiel: 35
Reichweite	0-100
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v2-v6 Thermostat lesen/schreiben / v2-v6

hvac_state

Zeigt an, ob das HLK-System aktiv heizt, kühlt oder ausgeschaltet ist. Verwenden Sie diesen Wert, um den HLK-Aktivitätsstatus anzuzeigen.

Wenn off , wird das HVAC - System nicht aktiv Heizen oder Kühlen. hvac_state ist unabhängig von Lüfterbetrieb.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Kehrt zurück	string enum Werte: „Heizen“, „Kühlen“, „Aus“
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v3-v6 Thermostat lesen/schreiben / v3-v6

where_id

Ein einzigartiger, Nest-generierten Identifikator, der darstellt , name , der Anzeigename der Vorrichtung.

Erfahren Sie mehr darüber , wo Namen für Nest Thermostats ,Nest schützt und Nest Cams .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Kehrt zurück	string Beispiel: "d6reb_OZTM..."
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v4-v6 Thermostat lesen/schreiben / v4-v6

ist gesperrt

Status der Thermostatsperre. Wenn wahr, die Thermostat Sperre ist Funktion aktiviert ist , und schränkt den Temperaturbereich auf diese Min- / Max - Werte: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c und locked_temp_max_c .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v5-v6 Thermostat lesen/schreiben / v5-v6

Locked_temp_min_f

Mindest Thermostat Sperre Temperatur angezeigt ganz Grad Fahrenheit (1 ° F). Wird verwendet , wenn is_locked ist true .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Kehrt zurück	string Beispiel: 65
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v5-v6 Thermostat lesen/schreiben / v5-v6

Locked_temp_max_f

Maximale Thermostat Sperre Temperatur ganz Grad Fahrenheit (1 ° F) angezeigt. Wird verwendet , wenn is_locked ist true .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Kehrt zurück	string Beispiel: 80
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v5-v6 Thermostat lesen/schreiben / v5-v6

Locked_temp_min_c

Minimum Thermostat Sperre Temperatur angezeigt displayed in einhalb Grad Celsius (0,5 ° C). Wird verwendet , wenn is_locked ist true .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Kehrt zurück	string Beispiel: 19,5
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v5-v6 Thermostat lesen/schreiben / v5-v6

Locked_temp_max_c

Maximum Thermostat Sperre Temperatur angezeigt displayed in einhalb Grad Celsius (0,5 ° C). Wird verwendet , wenn is_locked ist true .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Kehrt zurück	string Beispiel: 24,5
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v5-v6 Thermostat lesen/schreiben / v5-v6

Etikette

Thermostat benutzerdefinierte Beschriftung . Erscheint in Klammern nach dem Where-Namen.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /label
Kehrt zurück	string Beispiele: „Oben“, „Gästezimmer“, „Spielzimmer“
Zugriff	lesen Schreiben
Verfügbar in	Lesen: Thermostat lesen / v6 Thermostat lesen/schreiben / v6 Schreiben: Thermostat lesen/schreiben / v5-v6

Sonnenlicht_Korrektur_aktiviert

Status Sonnenblock aktiviert. Verwendet mit sunlight_correction_active . Wenn true ist Sunblock Technologie aktiviert und das Thermostat automatisch in direkten Sonnenlicht Einstellung, das Lesen und die richtige Temperatureinstellung.

Für weitere Informationen siehe, Was ist Sunblock?

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

Sonnenlicht_Korrektur_Aktiv

Sonnenblocker aktiver Status. Verwendet mit sunlight_correction_enabled . Wenn true , zeigt an, dass der Thermostat in der prallen Sonne liegt.

Für weitere Informationen siehe, Was ist Sunblock?

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

wo_name

Der Anzeigename des Geräts. Im Zusammenhang mit dem Thermostat where_id . Kann ein beliebiger Raumname aus einer von uns bereitgestellten Liste oder ein benutzerdefinierter Name sein. Erfahren Sie mehr darüber , wo Namen für Nest Thermostats ,Nest schützt und Nest Cams .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Kehrt zurück	string Beispiel: "Flur"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

fan_timer_duration

Gibt die Dauer (in Minuten) an, für die der Lüfter eingestellt ist.

Die fan_timer_active Einstellung schaltet den Ventilator. Der fan_timer_timeout Wert gibt die Zeitstempel , wenn fan_timer_duration zu Ende festgelegt ist.

Um zu erfahren , wie Kunden die Lüfter Timer einstellen, siehe Timer Dauer .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Kehrt zurück	int Werte: 15, 30, 45, 60, 120, 240, 480, 720
Zugriff	lesen Schreiben
Verfügbar in	Lesen: Thermostat lesen / v6 Thermostat lesen/schreiben / v6 Schreiben: Thermostat lesen/schreiben / v6

time_to_target

Die Zeit in Minuten, die die Struktur benötigt, um die Zieltemperatur zu erreichen.

Siehe Time-to-Temperatur für weitere Informationen.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Kehrt zurück	string enum Werte: "~0", "<5", "~15", "~90", "120"
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

time_to_target_training

Im Trainingsmodus lernt Nest Thermostat das HLK-System kennen und erkennt, wie lange es dauert, die Zieltemperatur zu erreichen. Wenn der Thermostat genügend Informationen hat eine vernünftige Schätzung der Zeit, um die Solltemperatur zu erreichen, wird dieser Wert von ändern training zu ready .

Siehe Time-to-Temperatur für weitere Informationen.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Kehrt zurück	string enum Werte: „training“, „ready“
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6

previous_hvac_mode

Zeigt die zuletzt gewählte hvac_mode . Wird verwendet , wenn von Schalt hvac_mode = eco auf einem Gerät mit veralteter Firmware.

Um mehr zu erfahren über die Umstellung betwen Eco und Nicht-Eco - Modus finden Sie in dem Thermostat - Führer .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Kehrt zurück	string Werte: „heat“, „cool“, „heat-cool“, „off“, leer (kein Wert)
Zugriff	schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6