Notice: We're retiring Works with Nest. See the home page for more information.

Diese Seite wurde von der Cloud Translation API übersetzt.

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ückgabe	`string` Beispiel: "peyiJNo0IldT2YlIVtYaGQ"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiele: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Access	Schreibgeschützt
Verfügbar in	Thermostat lesen / v1-v6 Thermostat lesen/schreiben / v1-v6

softwareversion

Software version.

Details
`https://developer-api.nest.com/devices/thermostats/device_id/software_version`
Rückgabe	`string` Beispiel: "4.0"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: "VqFabWH21nw..."
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: "Flur"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: "Flur (Thermostat)"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: 22016-12-31T23:59:59.000Z“
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	lesen/schreiben
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: 22016-12-31T23:59:59.000Z“
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string enum` Werte: "F", "C"
Access	lesen/schreiben
Verfügbar in	Lesen: 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ückgabe	`number` Beispiel: 72
Bereich	50-90
Access	lesen/schreiben
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 21,5
Bereich	9-32
Access	lesen/schreiben
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 80
Access	lesen/schreiben
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 24,5
Access	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 (Heizen • Kühlen).

Details
`https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f`
Rückgabe	`number` Beispiel: 65
Access	lesen/schreiben
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 19.5
Access	lesen/schreiben
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 80
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 24,5
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 65
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 19.5
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 80
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 24,5
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 65
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 19.5
Access	Schreibgeschützt
Verfügbar in	Thermostat 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.

hvac_mode kann geändert werden, wenn der Thermostat gesperrt ist
target_temperature_f und target_temperature_c können nicht geändert werden, wenn hvac_mode = off oder eco

Details
`https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode`
Rückgabe	`string enum` Werte: "heat", "cool", "heat-cool", "eco", "off"
Access	lesen/schreiben
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 72
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 21,5
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`number` Beispiel: 35
Bereich	0–100
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string enum` Werte: "Heizen", "Kühlen", "Aus"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: "d6reb_OZTM..."
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: 65
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: 80
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: 19.5
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: 24,5
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiele: "Etage", "Gastzimmer", "Spielzimmer"
Access	lesen/schreiben
Verfügbar in	Lesen: 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Beispiel: "Flur"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`int` Werte: 15, 30, 45, 60, 120, 240, 480, 720
Access	lesen/schreiben
Verfügbar in	Lesen: 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ückgabe	`string enum` Werte: "~0", "<5", "~15", "~90", "120"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string enum` Werte: "training", "ready"
Access	Schreibgeschützt
Verfügbar in	Thermostat 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ückgabe	`string` Werte: "heat", "cool", "heat-cool", "off", leer (kein Wert)
Access	Schreibgeschützt
Verfügbar in	Thermostat lesen / v6 Thermostat lesen/schreiben / v6