Google setzt sich dafür ein, die Rassengerechtigkeit für schwarze Gemeinschaften zu fördern. Siehe wie.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Thermostat API

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

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

Alle folgenden Werte finden Sie unter den einzelnen devices/thermostats/ device_id im JSON-Dokument.

Geräte ID

Eindeutige Kennung des Nest-Thermostats.

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 Präferenz für Sprache und Region (oder 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

structure_id

Struktur eindeutiger Bezeichner.

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 eine benutzerdefinierte (Beschriftung), die vom Benutzer 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

last_connection

Zeitstempel der letzten erfolgreichen Interaktion mit dem Nest-Dienst im 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

can_cool

Systemfä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

System Fä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 zur Kühlung.

Wenn die Notheizung eingeschaltet ist:

  • Der Benutzer kann die Zieltemperatur am Gerät einstellen, den Modus jedoch erst ändern, wenn die Notheizung ausgeschaltet ist
  • Der hvac_mode kann weiterhin über die API geändert werden

Siehe Was ist Notwärme? Weitere Informationen dazu, wie der 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 zur Steuerung des Lüfters unabhängig von Heizen oder Kühlen.

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. fan_timer_duration mit fan_timer_duration , um den Lüfter für eine (benutzerdefinierte) voreingestellte Dauer fan_timer_duration .

Weitere Informationen zum Einstellen der Lüfterdauer durch Kunden finden Sie unter Erweiterte Lüftersteuerung.

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, der anzeigt, wenn der Lüfter-Timer 0 (Stoppzeit) im ISO 8601- Format erreicht.

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 energiesparende Temperatur 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; wird 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

target_temperature_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
Angebot 50-90
Zugriff lesen Schreiben
Verfügbar in Thermostat lesen / v1-v6
Thermostat lesen / schreiben / v1-v6

target_temperature_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
Angebot 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 (Wärme • Kühl-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 (Wärme • Kühl-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 (Wärme • Kühl-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 (Wärme • Kühl-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 Öko-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 Öko-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 Öko-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 Öko-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 (DEPRECATED)

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

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

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

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 für HLK-Systeme an, z. B. Heizen • Kühlen für Systeme mit Heiz- und Kühlleistung oder Öko-Temperaturen zur Energieeinsparung.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Kehrt zurück string enum
Werte: "Wärme", "Kühl", "Wärme-Kühl", "Öko", "Aus"
Zugriff lesen Schreiben
Verfügbar in Thermostat lesen / v1-v6
Thermostat lesen / schreiben / v1-v6

Umgebungstemperatur_f

Am Gerät gemessene Temperatur 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

Am Gerät gemessene Temperatur 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

Die Luftfeuchtigkeit in Prozent (%), gemessen am Gerät, auf 5% gerundet.

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Kehrt zurück number
Beispiel: 35
Angebot 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.

Im off Zustand heizt oder kühlt das HLK-System nicht aktiv. hvac_state ist unabhängig vom hvac_state .

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

Eine eindeutige, von Nest generierte Kennung, die den name , den Anzeigenamen des Geräts, darstellt.

Erfahren Sie mehr darüber, wo Namen für Nest-Thermostate , Nest-Schutz und Nest-Kameras stehen .

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 Thermostatverriegelung. Wenn true, ist die Thermostat- locked_temp_min_f aktiviert und beschränkt den Temperaturbereich auf die folgenden 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

Minimale Thermostatverriegelungstemperatur , angezeigt in ganzen Grad Fahrenheit (1 ° F). Wird verwendet, wenn is_locked 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

gesperrter_temp_max_f

Maximale Thermostatverriegelungstemperatur , angezeigt in ganzen Grad Fahrenheit (1 ° F). Wird verwendet, wenn is_locked 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

Minimale Thermostatverriegelungstemperatur , angezeigt in halben Grad Celsius (0,5 ° C). Wird verwendet, wenn is_locked 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

gesperrter_temp_max_c

Maximale Thermostatverriegelungstemperatur , angezeigt in halben Grad Celsius (0,5 ° C). Wird verwendet, wenn is_locked 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: "Upstairs", "Guest Room", "Playroom"
Zugriff lesen Schreiben
Verfügbar in Lesen:
Thermostat lesen / v6
Thermostat lesen / schreiben / v6
Schreiben:
Thermostat lesen / schreiben / v5-v6

sunlight_correction_enabled

Sunblock-Aktivierungsstatus. Wird mit sunlight_correction_active . Wenn dies true , ist die Sunblock-Technologie aktiviert und der Thermostat stellt sich automatisch auf direktes Sonnenlicht ein und liest und stellt die richtige Temperatur ein.

Weitere Informationen finden Sie unter Was ist Sunblocker?

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

sunlight_correction_active

Sunblocker aktiver Status. Wird mit sunlight_correction_enabled . Wenn dies der true , bedeutet true , dass sich der Thermostat in direktem Sonnenlicht befindet.

Weitere Informationen finden Sie unter Was ist Sunblocker?

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

where_name

Der Anzeigename des Geräts. Verbunden 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-Thermostate , Nest-Schutz und Nest-Kameras stehen .

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 an, wie lange (in Minuten) der Lüfter laufen soll.

Die Einstellung fan_timer_active schaltet den Lüfter ein. Der Wert fan_timer_timeout gibt den Zeitstempel an, wenn fan_timer_duration auf end gesetzt ist.

Informationen zum Einstellen des Lüfter-Timers durch Kunden finden Sie unter 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.

Weitere Informationen finden Sie unter Time-to-Temperature .

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 der Nest-Thermostat das HLK-System kennen und ermittelt, wie lange es dauert, bis die Zieltemperatur erreicht ist. Wenn der Thermostat über genügend Informationen verfügt, um die Zeit bis zum Erreichen der Zieltemperatur angemessen abzuschätzen, ändert sich dieser Wert von training zu ready .

Weitere Informationen finden Sie unter Time-to-Temperature .

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

previous_hvac_mode

Zeigt den zuletzt ausgewählten hvac_mode . Wird beim Umschalten von hvac_mode = eco auf einem Gerät mit veralteter Firmware verwendet.

Weitere Informationen zum Umschalten zwischen Eco- und Nicht-Eco-Modi finden Sie im Thermostat-Handbuch .

Einzelheiten
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Kehrt zurück string
Werte: "Wärme", "Kühlen", "Hitze-Kühlen", "Aus", leer (kein Wert)
Zugriff schreibgeschützt
Verfügbar in Thermostat lesen / v6
Thermostat lesen / schreiben / v6