API del termostato

L'API Nest funziona con tutti i modelli di Nest Learning ThermostatTM, ad eccezione di Thermostat E con Heat Link nell'Unione Europea.

Gli utenti possono aggiungere più termostati Nest al gruppo devices/thermostats, fino al numero massimo per struttura. Quando effettui una chiamata a questa posizione, puoi accedere ai dati di Nest Thermostat (valori dei dati per i dispositivi nella struttura).

Tutti i valori riportati di seguito si trovano sotto devices/thermostats/device_id nel documento JSON.

ID dispositivo

Identificatore univoco di Nest Thermostat.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/device_id
Resistring
Esempio: "peyiJNo0IldT2YlIVtYaGQ"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

locale

Specifica la lingua e l'area geografica (o il paese).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/locale
Resistring
Esempi: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

versione_software

Versione software

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/software_version
Resistring
Esempio: "4.0"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

struttura_id

Identificatore univoco della struttura.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
Resistring
Esempio: "VqFabWH21nw..."
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

nome

Nome visualizzato del dispositivo. Può essere qualsiasi nome di stanza virtuale da un elenco fornito da noi o un nome personalizzato.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/name
Resistring
Esempio: "Corridoio"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

nome_lungo

Nome visualizzato lungo del dispositivo. Include un'etichetta personalizzata (etichettata), creata dall'utente o tramite wheres.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/name_long
Resistring
Esempio: "Termostato corridoio (piano superiore)"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

ultima_connessione

Timestamp dell'ultima interazione con il servizio Nest, in formato ISO 8601.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/last_connection
Resistring
Esempio: "2016-12-31T23:59:59.000Z"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

è_online

Stato della connessione del dispositivo al servizio Nest.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/is_online
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

can_cool

Capacità del sistema di raffreddamento (con CA).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/can_cool
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

can_heat

Capacità del sistema di riscaldare.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/can_heat
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

is_using_emergency_heat

Stato di riscaldamento di emergenza in impianti con pompe di calore per il raffreddamento.

Quando il riscaldamento di emergenza è acceso:

  • L'utente può regolare la temperatura ottimale sul dispositivo, ma non può cambiare la modalità finché l'impianto di riscaldamento di emergenza non viene spento
  • Il hvac_mode può comunque essere modificato tramite l'API

Vedi Che cos'è il riscaldamento di emergenza? per ulteriori informazioni su come il termostato Nest supporta il riscaldamento di emergenza.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

has_fan

Capacità del sistema di controllare la ventola indipendentemente dal riscaldamento o dal raffreddamento.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/has_fan
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

fan_timer_attivo

Indica se il timer della ventola è coinvolto; utilizzata con fan_timer_duration per attivare la ventola per una durata predefinita specificata dall'utente.

Consulta Controllo avanzato dei fan per ulteriori informazioni su come i clienti impostano la durata del ventilatore.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
Resiboolean
Valori: true, false
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

timeout_timer

Timestamp che mostra quando il timer della ventola raggiunge 0 (ora di fine), in formato ISO 8601.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout
Resistring
Esempio: "2016-12-31T23:59:59.000Z"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

has_leaf

Viene mostrato quando il termostato è impostato su una temperatura di risparmio energetico.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

temperatura_scala

Fahrenheit o Celsius; utilizzato con il display della temperatura.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale
Resistring enum
Valori: "F", "C"
Accessolettura/scrittura
Disponibile inLettura:
Lettura del termostato / v1-v6
Lettura/scrittura del termostato / v1-v6
Scrittura:
lettura del termostato/scrittura / v5-v6

temperatura_target_f

Temperatura richiesta, in gradi Fahrenheit (1 °F). Utilizzato quando hvac_mode = heat o cool.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f
Resinumber
Esempio: 72
Intervallo50-90
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

temperatura_target_c

Temperatura richiesta, in mezzo grado Celsius, 0,5°C. Utilizzato quando hvac_mode = heat o cool.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c
Resinumber
Esempio: 21.5
Intervallo9-32
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

target_temperature_high_f

Temperatura ottimale massima, visualizzata in gradi interi (1° F). Utilizzato quando hvac_mode = heat-cool (modalità Caldo • Freddo).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f
Resinumber
Esempio: 80
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

target_temperature_high_c

Temperatura ottimale massima, visualizzata in mezzo grado Celsius (0,5 °C). Utilizzato quando hvac_mode = heat-cool (modalità Caldo Freddo).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c
Resinumber
Esempio: 24.5
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

target_temperature_low_f

Temperatura ottimale minima, visualizzata in gradi Fahrenheit (1 °F). Utilizzato quando hvac_mode = heat-cool (modalità Caldo • Freddo).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f
Resinumber
Esempio: 65
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

target_temperature_low_c

Temperatura ottimale minima, visualizzata in mezzo grado (0,5 °C). Utilizzato quando hvac_mode = heat-cool (modalità Caldo Freddo).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c
Resinumber
Esempio: 19.5
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

eco_temperature_high_f

Temperatura Eco massima, visualizzata in gradi Fahrenheit (1° F). Utilizzato quando hvac_mode = eco.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
Resinumber
Esempio: 80
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

eco_temperature_high_c

Temperatura Eco massima, visualizzata in mezzo grado Celsius (0,5°C). Utilizzato quando hvac_mode = eco.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
Resinumber
Esempio: 24.5
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

eco_temperature_low_f

Temperatura Eco minima visualizzata in gradi Fahrenheit (1 °F). Utilizzato quando hvac_mode = eco.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
Resinumber
Esempio: 65
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

eco_temperature_low_c

Temperatura Eco minima, visualizzata in mezzo grado Celsius (0,5°C). Utilizzato quando hvac_mode = eco.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c
Resinumber
Esempio: 19.5
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

away_temperature_high_f (DEPRECATO)

Temperatura massima fuori casa, visualizzata in gradi Fahrenheit (1 °F).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f
Resinumber
Esempio: 80
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

away_temperature_high_c (DEPRECATO)

Temperatura massima assente, visualizzata in mezzo Celsius (0,5 °C).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c
Resinumber
Esempio: 24.5
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

away_temperature_low_f (DEPRECATO)

Temperatura minima totale, visualizzata in gradi interi (1° F).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f
Resinumber
Esempio: 65
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

away_temperature_low_c (DEPRECATO)

Temperatura minima minima, visualizzata in gradi Celsius a 0,5 °C.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
Resinumber
Esempio: 19.5
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

modalità_HVAC

Indica le modalità Riscaldamento/raffreddamento dell'impianto HVAC, ad esempio Caldo • Freddo per impianti con capacità di riscaldamento e raffreddamento o Temperature Eco per il risparmio energetico.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
Resistring enum
Valori: "heat", "cool", "heat-cool", "eco", "off"
Accessolettura/scrittura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

ambiente_temperatura_f

Temperatura misurata sul dispositivo, in gradi Fahrenheit.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
Resinumber
Esempio: 72
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

ambiente_temperatura_c

Temperatura, misurata al dispositivo, in mezzo gradi Celsius (0,5 °C).

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c
Resinumber
Esempio: 21.5
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura/termostato/v1-v6

umidità

Umidità, in percentuale (%), misurata al dispositivo, arrotondata al 5% più vicino.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/humidity
Resinumber
Esempio: 35
Intervallo0-100
Accessosola lettura
Disponibile inLettura del termostato / v2-v6
Lettura/scrittura del termostato / v2-v6

stato_hvac

Indica se l'impianto HVAC è in fase di riscaldamento, raffreddamento o è spento. Utilizza questo valore per indicare lo stato dell'attività HVAC.

Quando off, l'impianto HVAC non è attivo per il riscaldamento o il raffreddamento. hvac_state non dipende dal funzionamento della ventola.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state
Resistring enum
Valori: "riscaldamento", "raffreddamento", "off"
Accessosola lettura
Disponibile inLettura del termostato/v3-v6
Lettura/scrittura/termostato/v3-v6

Dove_id

Un identificatore univoco generato da Nest che rappresenti name, il nome visualizzato del dispositivo.

Scopri di più sui nomi di Nest Thermostat, Nest Protect e Nest Cam.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/where_id
Resistring
Esempio: "d6reb_OZTM..."
Accessosola lettura
Disponibile inLettura del termostato/v4-v6
Lettura/scrittura/termostato/v4-v6

è_bloccato

Stato di blocco del termostato. Se impostato su vero, la funzionalità Blocco termostato è attivata e limita l'intervallo di temperature a questi valori min/max: locked_temp_min_f, locked_temp_max_f, locked_temp_min_c e locked_temp_max_c.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/is_locked
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v5-v6
Lettura/scrittura/termostato/v5-v6

bloccata_temp_min_f

Temperatura minima di blocco del termostato, visualizzata in gradi interi (1°F). Utilizzato quando is_locked è true.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f
Resistring
Esempio: 65
Accessosola lettura
Disponibile inLettura del termostato/v5-v6
Lettura/scrittura/termostato/v5-v6

bloccata_temp_max_f

Temperatura massima di blocco del termostato, visualizzata in gradi interi (1°F). Utilizzato quando is_locked è true.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
Resistring
Esempio: 80
Accessosola lettura
Disponibile inLettura del termostato/v5-v6
Lettura/scrittura/termostato/v5-v6

bloccata_temp_min_c

Temperatura minima di blocco del termostato, visualizzata in mezzo grado Celsius (0,5 °C). Utilizzato quando is_locked è true.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
Resistring
Esempio: 19.5
Accessosola lettura
Disponibile inLettura del termostato/v5-v6
Lettura/scrittura/termostato/v5-v6

bloccata_temp_max_c

Temperatura massima di blocco del termostato, visualizzata in mezzo grado Celsius (0,5 °C). Utilizzato quando is_locked è true.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
Resistring
Esempio: 24.5
Accessosola lettura
Disponibile inLettura del termostato/v5-v6
Lettura/scrittura/termostato/v5-v6

etichetta

Etichetta personalizzata del termostato. Viene visualizzato tra parentesi, dopo il nome del luogo.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/label
Resistring
Esempi: "Piano superiore", "Stanza", "Stanza"
Accessolettura/scrittura
Disponibile inLettura:
Lettura del termostato / v6
Lettura/scrittura del termostato / v6
Scrittura:
lettura/scrittura del termostato / v5 -v6

luce_corretta_attivata

Stato abilitato per Sunblock. Utilizzato con sunlight_correction_active. Quando la funzionalità true, la funzionalità Sunblock è attivata e il termostato si regola automaticamente per la luce diretta del sole, legge e imposta la temperatura corretta.

Per ulteriori informazioni, consulta la pagina relativa a Sunblock.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

luce_corretta_attiva

Stato attivo di Sunblock. Utilizzato con sunlight_correction_enabled. Se true, indica che il termostato si trova alla luce diretta del sole.

Per ulteriori informazioni, consulta la pagina relativa a Sunblock.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
Resiboolean
Valori: true, false
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

nome_dove

Il nome visualizzato del dispositivo. Associata al termostato where_id. Può essere il nome di una stanza virtuale da un elenco fornito da noi o un nome personalizzato. Scopri di più sui nomi di Nest Thermostat, Nest Protect e Nest Cam.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/where_name
Resistring
Esempio: "Corridoio"
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

fan_timer_duration

Specifica il periodo di tempo (in minuti) in cui il ventilatore è impostato per l'esecuzione.

L'impostazione fan_timer_active attiva la ventola. Il valore fan_timer_timeout indica il timestamp impostato su fan_timer_duration per la fine.

Per informazioni su come i clienti impostano il timer della ventola, vedi Durata del timer.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration
Resiint
Valori: 15, 30, 45, 60, 120, 240, 480, 720
Accessolettura/scrittura
Disponibile inLettura:
Lettura del termostato / v6
Lettura/scrittura del termostato / v6
Scrittura:
lettura/scrittura del termostato / v6

ora_target

Il tempo, in minuti, necessario alla struttura per raggiungere la temperatura ottimale.

Per ulteriori informazioni, consulta Tempo per raggiungimento temperatura.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target
Resistring enum
Valori: "~0", "<5", "~15", "~90", "120"
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

tempo_di_formazione_target

In modalità di addestramento, Nest Thermostat apprende l'impianto HVAC e rileva il tempo necessario per raggiungere la temperatura ottimale. Quando il termostato dispone di informazioni sufficienti a fare una stima ragionevole del tempo per raggiungere la temperatura ottimale, questo valore cambierà da training a ready.

Per ulteriori informazioni, consulta Tempo per raggiungimento temperatura.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
Resistring enum
Valori: "training", "ready"
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6

previous_hvac_mode

Mostra l'ultimo elemento hvac_mode selezionato. Utilizzato quando si passa da hvac_mode = eco su un dispositivo con firmware obsoleto.

Per scoprire di più sul passaggio tra le modalità Eco e non Eco, consulta la Guida al termostato.

Dettagli
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
Resistring
Valori: "heat", "cool", "heat-cool", "off", vuoto (nessun valore)
Accessosola lettura
Disponibile inLettura del termostato/v6
Lettura/scrittura/termostato/v6