Thermostat-API

Die Nest API funktioniert mit allen Nest Learning ThermostatTM-Modellen, außer dem Thermostat E mit Heat Link in der EU.

Nutzer können der Gruppe devices/thermostats mehrere Nest Thermostate hinzufügen, bis zum Höchstwert pro Struktur. Wenn Sie diesen Datenstandort aufrufen, können Sie auf Nest Thermostat-Daten (Datenwerte für Geräte im Gebäude) zugreifen.

Alle unten stehenden Werte befinden sich unter devices/thermostats/device_id im JSON-Dokument.

device_id [Geräte-ID]

Eindeutige Kennung des Nest Thermostats.

Details
https://developer-api.nest.com/devices/thermostats/device_id/device_id
Rückgabestring
Beispiel: "peyiJNo0IldT2YlIVtYaGQ"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

locale

Legt die Einstellung für Sprache und Region (oder Land) fest.

Details
https://developer-api.nest.com/devices/thermostats/device_id/locale
Rückgabestring
Beispiele: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

softwareversion

Software version.

Details
https://developer-api.nest.com/devices/thermostats/device_id/software_version
Rückgabestring
Beispiel: "4.0"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Bauwerks-ID

Eindeutige ID des Gebäudes.

Details
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
Rückgabestring
Beispiel: "VqFabWH21nw..."
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Name

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/name
Rückgabestring
Beispiel: "Flur"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Name_Lang

Langer Anzeigename des Geräts. Enthält ein benutzerdefiniertes Label (Label), das vom Nutzer oder über wheres erstellt wurde.

Details
https://developer-api.nest.com/devices/thermostats/device_id/name_long
Rückgabestring
Beispiel: "Flur (Thermostat)"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

letzte_Verbindung

Zeitstempel der letzten erfolgreichen Interaktion mit dem Nest-Dienst im ISO 8601-Format.

Details
https://developer-api.nest.com/devices/thermostats/device_id/last_connection
Rückgabestring
Beispiel: 22016-12-31T23:59:59.000Z“
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

ist_online

Geräteverbindungsstatus mit dem Nest-Dienst

Details
https://developer-api.nest.com/devices/thermostats/device_id/is_online
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

kann_kühlen

Kühlfähigkeit des Systems (mit Klimaanlage).

Details
https://developer-api.nest.com/devices/thermostats/device_id/can_cool
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Can_heat

Heizfähigkeit des Systems.

Details
https://developer-api.nest.com/devices/thermostats/device_id/can_heat
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

is_using_emergency_heat

Status der Notheizung in Systemen mit Wärmepumpen zur Kühlung.

Wenn die Notheizung eingeschaltet ist:

  • Der Nutzer kann die Zieltemperatur auf dem Gerät anpassen, den Modus aber erst ändern, wenn die Notheizung ausgeschaltet wird.
  • hvac_mode kann weiterhin über die API geändert werden

Weitere Informationen dazu, wie der Nest Thermostat die Notheizung unterstützt, finden Sie unter Was ist Notheizung?.

Details
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

has_fan

Systemfunktion zur Lüftungssteuerung unabhängig von Heizung und Kühlung.

Details
https://developer-api.nest.com/devices/thermostats/device_id/has_fan
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

fan_timer_aktiv

Gibt an, ob der Lüfter-Timer aktiv ist; wird zusammen mit fan_timer_duration verwendet, um den Lüfter für eine (vom Nutzer festgelegte) voreingestellte Dauer zu aktivieren.

Weitere Informationen dazu, wie Kunden die Lüfterdauer festlegen, finden Sie unter Erweiterte Lüftersteuerung.

Details
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
Rückgabeboolean
Werte: true, false
Accesslesen/schreiben
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Zeit für Fan_timer_timeout

Zeitstempel, der angibt, wann der Lüfter-Timer 0 (Stoppzeit) erreicht, im ISO-8601-Format

Details
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout
Rückgabestring
Beispiel: 22016-12-31T23:59:59.000Z“
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

has_leaf

Wird angezeigt, wenn der Thermostat auf eine energiesparende Temperatur eingestellt ist.

Details
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Temperaturskala

Fahrenheit oder Celsius wird zusammen mit der Temperaturanzeige verwendet.

Details
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale
Rückgabestring enum
Werte: "F", "C"
Accesslesen/schreiben
Verfügbar inLesen:
Lesen des Thermostats / v1-v6
Lesen/Schreiben des Thermostats / v1-v6
Schreiben:
Lesen des Thermostats/write / v5-v6

target_temperature_f

Gewünschte Temperatur in vollen Grad Fahrenheit. Wird verwendet, wenn hvac_mode = heat oder cool ist.

Details
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f
Rückgabenumber
Beispiel: 72
Bereich50-90
Accesslesen/schreiben
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

target_temperature_c

Gewünschte Temperatur in halben Grad Celsius. Wird verwendet, wenn hvac_mode = heat oder cool ist.

Details
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c
Rückgabenumber
Beispiel: 21,5
Bereich9-32
Accesslesen/schreiben
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

target_temperature_high_f (Zieltemperatur)

Maximale Zieltemperatur, angezeigt in ganzen Grad Fahrenheit (1 °F). Wird verwendet, wenn hvac_mode = heat-cool (Heizen • Kühlen).

Details
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f
Rückgabenumber
Beispiel: 80
Accesslesen/schreiben
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

target_temperature_high_c (Zieltemperatur)

Maximale Zieltemperatur, angegeben in halben Grad Celsius (0,5 °C). Wird verwendet, wenn hvac_mode = heat-cool (Heizen • Kühlen).

Details
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c
Rückgabenumber
Beispiel: 24,5
Accesslesen/schreiben
Verfügbar inThermostat 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 (Heizen • Kühlen).

Details
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f
Rückgabenumber
Beispiel: 65
Accesslesen/schreiben
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

target_temperature_low_c [Zieltemperatur_niedrig_c]

Minimale Zieltemperatur, angezeigt in halben Grad Celsius (0,5 °C). Wird verwendet, wenn hvac_mode = heat-cool (Heizen • Kühlen).

Details
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c
Rückgabenumber
Beispiel: 19.5
Accesslesen/schreiben
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Eco-Temperatur_hohe_f

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
Rückgabenumber
Beispiel: 80
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

Eco-Temperatur_hohe_c

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
Rückgabenumber
Beispiel: 24,5
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

Eco_temperature_niedrig_f

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
Rückgabenumber
Beispiel: 65
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

Eco_temperature_niedrig_c

Minimale Eco-Temperatur, angezeigt in 0,5 °C. Wird verwendet, wenn hvac_mode = eco.

Details
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c
Rückgabenumber
Beispiel: 19.5
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

away_temperature_high_f (EINGESTELLT)

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f
Rückgabenumber
Beispiel: 80
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

away_temperature_high_c (EINGESTELLT)

Die maximale Abwesenheitstemperatur wird in halben Grad Celsius angezeigt.

Details
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c
Rückgabenumber
Beispiel: 24,5
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

away_temperature_low_f (EINGESTELLT)

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f
Rückgabenumber
Beispiel: 65
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

away_temperature_low_c (EINGESTELLT)

Minimale Temperatur in Abwesenheit, angezeigt in halben Grad Celsius.

Details
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
Rückgabenumber
Beispiel: 19.5
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

hvac_mode

Gibt den Heiz-/Kühlmodus des HLK-Systems an, z. B. Heizen/Kühlen für Systeme mit Heiz- und Kühlkapazität oder Eco-Temperaturen für Energieeinsparungen.

Details
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
Rückgabestring enum
Werte: "heat", "cool", "heat-cool", "eco", "off"
Accesslesen/schreiben
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Umgebungstemperatur

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
Rückgabenumber
Beispiel: 72
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Umgebungstemperatur_c

Die Temperatur wird auf dem Gerät in halben Grad Celsius gemessen.

Details
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c
Rückgabenumber
Beispiel: 21,5
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v1-v6
Thermostat lesen/schreiben / v1-v6

Feuchtigkeit

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

Details
https://developer-api.nest.com/devices/thermostats/device_id/humidity
Rückgabenumber
Beispiel: 35
Bereich0–100
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v2-v6
Thermostat lesen/schreiben / v2-v6

hvac_state

Gibt an, ob das HLK-System Heizen, Kühlen oder ausgeschaltet ist. Verwenden Sie diesen Wert, um den Status der HLK-Aktivität anzugeben.

Wenn off, ist das HLK-System nicht aktiv Heizen oder Kühlen. hvac_state ist unabhängig vom Lüftervorgang.

Details
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state
Rückgabestring enum
Werte: "Heizen", "Kühlen", "Aus"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v3-v6
Thermostat lesen/schreiben / v3-v6

Where_ID

Eine eindeutige, von Nest generierte Kennung, die für name steht, den Anzeigenamen des Geräts.

Weitere Informationen zu den Namen von Nest Thermostaten, Nest Protect-Geräten und Nest Cams

Details
https://developer-api.nest.com/devices/thermostats/device_id/where_id
Rückgabestring
Beispiel: "d6reb_OZTM..."
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v4-v6
Thermostat lesen/schreiben / v4-v6

ist_gesperrt

Thermostat-Schloss-Status. Wenn der Wert truetrue“ ist, ist die Funktion Thermostatsperre aktiviert und schränkt den Temperaturbereich auf diese Mindest-/Maximalwerte ein: locked_temp_min_f, locked_temp_max_f, locked_temp_min_c und locked_temp_max_c.

Details
https://developer-api.nest.com/devices/thermostats/device_id/is_locked
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v5-v6
Thermostat lesen/schreiben / v5-v6

Sperrzeit_min_f

Mindesttemperatur für Thermostatsperre, die in ganzen Grad Fahrenheit (1 °F) angezeigt wird. Wird verwendet, wenn is_locked true ist.

Details
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f
Rückgabestring
Beispiel: 65
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v5-v6
Thermostat lesen/schreiben / v5-v6

Sperrzeit_max_f

Maximale Temperatur für Thermostatsperre, angezeigt in ganzen Grad Fahrenheit (1 °F). Wird verwendet, wenn is_locked true ist.

Details
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
Rückgabestring
Beispiel: 80
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v5-v6
Thermostat lesen/schreiben / v5-v6

Sperrzeit_min_c

Mindesttemperatur für Thermostatsperre, die in halben Grad Celsius (0,5 °C) angezeigt wird. Wird verwendet, wenn is_locked true ist.

Details
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
Rückgabestring
Beispiel: 19.5
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v5-v6
Thermostat lesen/schreiben / v5-v6

gesperrt_temp_max_c

Maximale Temperatur für Thermostatsperre, angegeben in halben Grad Celsius (0,5 °C). Wird verwendet, wenn is_locked true ist.

Details
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
Rückgabestring
Beispiel: 24,5
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v5-v6
Thermostat lesen/schreiben / v5-v6

label

Benutzerdefiniertes Label des Thermostats. Erscheint in Klammern hinter dem "where"-Namen.

Details
https://developer-api.nest.com/devices/thermostats/device_id/label
Rückgabestring
Beispiele: "Etage", "Gastzimmer", "Spielzimmer"
Accesslesen/schreiben
Verfügbar inLesen:
Lesen/Schreiben/Thermostat
Lesen/Schreiben/Thermostat/V6
Schreiben:
Lesen/Schreiben Thermostat/V5 -v6

Sonnenlichtkorrektur aktiviert

Sunblocker-Status. Wird mit sunlight_correction_active verwendet. Wenn true aktiviert ist, wird die Sunblocker-Technologie aktiviert und der Thermostat stellt sich automatisch auf direkte Sonneneinstrahlung ein. Außerdem wird die richtige Temperatur gelesen und festgelegt.

Weitere Informationen finden Sie unter Was ist Sunblocker?

Details
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

Sonnenlichtkorrektur

Aktiver Sunblocker-Status. Wird mit sunlight_correction_enabled verwendet. Bei true wird der Thermostat bei direkter Sonneneinstrahlung angezeigt.

Weitere Informationen finden Sie unter Was ist Sunblocker?

Details
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
Rückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

Where_Name

Der angezeigte Name des Geräts. Verknüpft mit dem Thermostat where_id Dies kann ein beliebiger Raumname aus einer von uns bereitgestellten Liste oder ein benutzerdefinierter Name sein. Weitere Informationen zu den Namen von Nest Thermostaten, Nest Protect-Geräten und Nest Cams

Details
https://developer-api.nest.com/devices/thermostats/device_id/where_name
Rückgabestring
Beispiel: "Flur"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

Lüfter_Dauer

Gibt die Zeit in Minuten an, die der Lüfter ausgeführt werden soll.

Mit der Einstellung fan_timer_active wird der Lüfter eingeschaltet. Der Wert fan_timer_timeout gibt den Zeitstempel an, wenn fan_timer_duration auf setEnde“ eingestellt ist.

Informationen dazu, wie Kunden den Lüfter-Timer einstellen, finden Sie unter Timer-Dauer.

Details
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration
Rückgabeint
Werte: 15, 30, 45, 60, 120, 240, 480, 720
Accesslesen/schreiben
Verfügbar inLesen:
Lesen/Schreiben/Thermostat
Lesen/Schreiben/Thermostat/V6
Schreiben:
Lesen/Schreiben Thermostat / V6

Zielzeit

Die Zeit in Minuten, die benötigt wird, bis die Struktur die Zieltemperatur erreicht.

Weitere Informationen findest du unter Temperatur-Countdown.

Details
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target
Rückgabestring enum
Werte: "~0", "<5", "~15", "~90", "120"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

Zielzeittraining

Im Trainingsmodus lernt der Nest Thermostat das HLK-System und erkennt, wie lange es dauert, die Zieltemperatur zu erreichen. Wenn der Thermostat genügend Informationen hat, um eine angemessene Zeit zum Erreichen der Zieltemperatur anzugeben, ändert sich dieser Wert von training in ready.

Weitere Informationen findest du unter Temperatur-Countdown.

Details
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
Rückgabestring enum
Werte: "training", "ready"
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6

vorherige_hvac_mode

Das zuletzt ausgewählte hvac_mode wird angezeigt. Wird beim Wechsel von hvac_mode = eco auf einem Gerät mit veralteter Firmware verwendet.

Weitere Informationen zum Wechseln zwischen den Eco- und Nicht-Eco-Modi finden Sie in der Thermostat-Anleitung.

Details
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
Rückgabestring
Werte: "heat", "cool", "heat-cool", "off", leer (kein Wert)
AccessSchreibgeschützt
Verfügbar inThermostat lesen / v6
Thermostat lesen/schreiben / v6