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

Questa pagina è stata tradotta dall'API Cloud Translation.

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`
Resi	`string` Esempio: "peyiJNo0IldT2YlIVtYaGQ"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempi: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "4.0"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "VqFabWH21nw..."
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "Corridoio"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "Termostato corridoio (piano superiore)"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "2016-12-31T23:59:59.000Z"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "2016-12-31T23:59:59.000Z"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string enum` Valori: "F", "C"
Accesso	lettura/scrittura
Disponibile in	Lettura: 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`
Resi	`number` Esempio: 72
Intervallo	50-90
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 21.5
Intervallo	9-32
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 80
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 24.5
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 65
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 19.5
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 80
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 24.5
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 65
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 19.5
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 80
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 24.5
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 65
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 19.5
Accesso	sola lettura
Disponibile in	Lettura 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.

hvac_mode può essere modificato se il termostato è bloccato
target_temperature_f e target_temperature_c non possono essere modificati se hvac_mode = off o eco

Dettagli
`https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode`
Resi	`string enum` Valori: "heat", "cool", "heat-cool", "eco", "off"
Accesso	lettura/scrittura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 72
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 21.5
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`number` Esempio: 35
Intervallo	0-100
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string enum` Valori: "riscaldamento", "raffreddamento", "off"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "d6reb_OZTM..."
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: 65
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: 80
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: 19.5
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: 24.5
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempi: "Piano superiore", "Stanza", "Stanza"
Accesso	lettura/scrittura
Disponibile in	Lettura: 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`boolean` Valori: true, false
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Esempio: "Corridoio"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`int` Valori: 15, 30, 45, 60, 120, 240, 480, 720
Accesso	lettura/scrittura
Disponibile in	Lettura: 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`
Resi	`string enum` Valori: "~0", "<5", "~15", "~90", "120"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string enum` Valori: "training", "ready"
Accesso	sola lettura
Disponibile in	Lettura 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`
Resi	`string` Valori: "heat", "cool", "heat-cool", "off", vuoto (nessun valore)
Accesso	sola lettura
Disponibile in	Lettura del termostato/v6 Lettura/scrittura/termostato/v6