Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

API termostato

L'API Nest funziona con tutti i modelli Nest Learning Thermostat ™, ad eccezione del termostato E con Heat Link nell'UE.

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

Tutti i valori seguenti si trovano sotto ciascun devices/thermostats/ device_id nel documento JSON.

ID del dispositivo

Identificatore univoco del termostato Nest.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
ritorna string
Esempio: "peyiJNo0IldT2YlIVtYaGQ"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

località

Specifica la lingua e la regione (o paese) preferenza.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locale
ritorna string
Esempi: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

versione software

Versione software.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
ritorna string
Esempio: "4.0"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

structure_id

Identificatore univoco della struttura.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
ritorna string
Esempio: "VqFabWH21nw ..."
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

nome

Visualizza il nome del dispositivo. Può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /name
ritorna string
Esempio: "Corridoio"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

NAME_LONG

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
ritorna string
Esempio: "Termostato corridoio (piano superiore)"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

last_connection

Data / ora dell'ultima interazione riuscita con il servizio Nest, in formato ISO 8601 .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
ritorna string
Esempio: "2016-12-31T23: 59: 59.000Z"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

è in linea

Stato della connessione del dispositivo con il servizio Nest.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

can_cool

Capacità del sistema di raffreddamento (ha AC).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

can_heat

Capacità del sistema di riscaldare.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

is_using_emergency_heat

Stato del calore di emergenza in sistemi con pompe di calore per il raffreddamento.

Quando il riscaldamento di emergenza è attivo:

  • L'utente può regolare la temperatura target sul dispositivo, ma non può cambiare la modalità fino allo spegnimento del riscaldamento di emergenza
  • La modalità hvac_mode può ancora essere modificata tramite l'API

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / 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
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

fan_timer_active

Indica se il timer della ventola è attivato; utilizzato con fan_timer_duration per accendere il ventilatore per una durata preimpostata (specificata dall'utente).

Vedere Controllo avanzato della ventola per ulteriori informazioni su come i clienti impostano la durata della ventola.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
ritorna boolean
Valori: vero, falso
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

fan_timer_timeout

Timestamp che mostra quando il timer della ventola raggiunge 0 (tempo di arresto), nel formato ISO 8601 .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
ritorna string
Esempio: "2016-12-31T23: 59: 59.000Z"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

has_leaf

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

temperature_scale

Fahrenheit o Celsius; utilizzato con display della temperatura.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
ritorna string enum
Valori: "F", "C"
Accesso leggere scrivere
Disponibile in Leggere:
Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Scrivi:
Termostato di lettura / scrittura / v5-v6

target_temperature_f

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
ritorna number
Esempio: 72
Gamma 50-90
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

target_temperature_c

Temperatura desiderata, 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
ritorna number
Esempio: 21.5
Gamma 9-32
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

target_temperature_high_f

Temperatura target massima, visualizzata in gradi interi Fahrenheit (1 ° F). Utilizzato quando hvac_mode = heat-cool (modalità Heat • Cool).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
ritorna number
Esempio: 80
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

target_temperature_high_c

Temperatura target massima, visualizzata in mezzo grado Celsius (0,5 ° C). Utilizzato quando hvac_mode = heat-cool (modalità Heat • Cool).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
ritorna number
Esempio: 24.5
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

target_temperature_low_f

Temperatura target minima, visualizzata in gradi interi Fahrenheit (1 ° F). Utilizzato quando hvac_mode = heat-cool (modalità Heat • Cool).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
ritorna number
Esempio: 65
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

target_temperature_low_c

Temperatura target minima, visualizzata in mezzo grado Celsius (0,5 ° C). Utilizzato quando hvac_mode = heat-cool (modalità Heat • Cool).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
ritorna number
Esempio: 19.5
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

eco_temperature_high_f

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
ritorna number
Esempio: 80
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

eco_temperature_high_c

Temperatura ecologica massima, visualizzata a 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
ritorna number
Esempio: 24.5
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

eco_temperature_low_f

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
ritorna number
Esempio: 65
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

eco_temperature_low_c

Temperatura ecologica minima, visualizzata a 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
ritorna number
Esempio: 19.5
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

away_temperature_high_f (DEPRECATED)

Temperatura massima assente, visualizzata in gradi interi Fahrenheit (1 ° F).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
ritorna number
Esempio: 80
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

away_temperature_high_c (DEPRECATED)

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
ritorna number
Esempio: 24.5
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

away_temperature_low_f (DEPRECATED)

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
ritorna number
Esempio: 65
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

away_temperature_low_c (DEPRECATED)

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
ritorna number
Esempio: 19.5
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

hvac_mode

Indica le modalità di riscaldamento / raffreddamento del sistema HVAC, come Heat • Cool per sistemi con capacità di riscaldamento e raffreddamento o Eco Temperature per il risparmio energetico.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
ritorna string enum
Valori: "heat", "cool", "heat-cool", "eco", "off"
Accesso leggere scrivere
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

ambient_temperature_f

Temperatura, misurata sul dispositivo, in gradi interi Fahrenheit (1 ° F).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
ritorna number
Esempio: 72
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

ambient_temperature_c

Temperatura, misurata sul dispositivo, in mezzo grado Celsius (0,5 ° C).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
ritorna number
Esempio: 21.5
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6

umidità

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
ritorna number
Esempio: 35
Gamma 0-100
Accesso sola lettura
Disponibile in Termostato letto / v2-v6
Termostato di lettura / scrittura / v2-v6

hvac_state

Indica se il sistema HVAC si sta riscaldando, raffreddando o è spento. Utilizzare questo valore per indicare lo stato dell'attività HVAC.

Se off , il sistema HVAC non sta riscaldando o raffreddando attivamente. hvac_state è indipendente dal funzionamento della ventola.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
ritorna string enum
Valori: "riscaldamento", "raffreddamento", "off"
Accesso sola lettura
Disponibile in Termostato letto / v3-v6
Termostato di lettura / scrittura / v3-v6

where_id

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

Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
ritorna string
Esempio: "d6reb_OZTM ..."
Accesso sola lettura
Disponibile in Termostato letto / v4-v6
Termostato di lettura / scrittura / v4-v6

è bloccato

Stato blocco termostato. Se vero, la funzione Blocco termostato è abilitata e limita l'intervallo di temperatura 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
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v5-v6
Termostato di lettura / scrittura / v5-v6

locked_temp_min_f

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
ritorna string
Esempio: 65
Accesso sola lettura
Disponibile in Termostato letto / v5-v6
Termostato di lettura / scrittura / v5-v6

locked_temp_max_f

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

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
ritorna string
Esempio: 80
Accesso sola lettura
Disponibile in Termostato letto / v5-v6
Termostato di lettura / scrittura / v5-v6

locked_temp_min_c

Temperatura minima di blocco termostato , visualizzata in visualizzata a 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
ritorna string
Esempio: 19.5
Accesso sola lettura
Disponibile in Termostato letto / v5-v6
Termostato di lettura / scrittura / v5-v6

locked_temp_max_c

Temperatura massima blocco termostato , visualizzata in visualizzata a 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
ritorna string
Esempio: 24.5
Accesso sola lettura
Disponibile in Termostato letto / v5-v6
Termostato di lettura / scrittura / v5-v6

etichetta

Etichetta personalizzata termostato. Appare tra parentesi, dopo il nome where.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /label
ritorna string
Esempi: "Al piano superiore", "Camera degli ospiti", "Sala giochi"
Accesso leggere scrivere
Disponibile in Leggere:
Termostato letto / v6
Termostato di lettura / scrittura / v6
Scrivi:
Termostato di lettura / scrittura / v5-v6

sunlight_correction_enabled

Stato abilitato per Sunblock. Utilizzato con sunlight_correction_active . Se true , la tecnologia Sunblock è abilitata e il termostato si regola automaticamente alla luce solare diretta, leggendo e impostando la temperatura corretta.

Per altre info, vedi Cos'è Sunblock?

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

sunlight_correction_active

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

Per altre info, vedi Cos'è Sunblock?

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

where_name

Il nome visualizzato del dispositivo. Associato al termostato where_id . Può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato. Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
ritorna string
Esempio: "Corridoio"
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

fan_timer_duration

Specifica il periodo di tempo (in minuti) in cui la ventola è impostata per funzionare.

L'impostazione fan_timer_active attiva il ventilatore. Il valore fan_timer_timeout indica il timestamp quando fan_timer_duration è impostato alla fine.

Per sapere come i clienti impostano il timer della ventola, vedere Durata del timer .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
ritorna int
Valori: 15, 30, 45, 60, 120, 240, 480, 720
Accesso leggere scrivere
Disponibile in Leggere:
Termostato letto / v6
Termostato di lettura / scrittura / v6
Scrivi:
Termostato di lettura / scrittura / v6

time_to_target

Il tempo, in minuti, impiegato dalla struttura per raggiungere la temperatura target.

Vedere Time-to-Temperature per ulteriori informazioni.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
ritorna string enum
Valori: "~ 0", "<5", "~ 15", "~ 90", "120"
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

time_to_target_training

In modalità allenamento, Nest Thermostat viene a conoscenza del sistema HVAC e scopre quanto tempo impiega per raggiungere la temperatura target. Quando il termostato dispone di informazioni sufficienti per fare una stima ragionevole del tempo per raggiungere la temperatura target, questo valore cambierà da training a ready .

Vedere Time-to-Temperature per ulteriori informazioni.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
ritorna string enum
Valori: "training", "ready"
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6

previous_hvac_mode

Visualizza l'ultima hvac_mode selezionata. Utilizzato quando si passa da hvac_mode = eco su un dispositivo con firmware obsoleto.

Per ulteriori informazioni sul passaggio tra le modalità Eco e non Eco, consultare la Guida al termostato .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
ritorna string
Valori: "riscaldamento", "freddo", "caldo-freddo", "spento", vuoto (nessun valore)
Accesso sola lettura
Disponibile in Termostato letto / v6
Termostato di lettura / scrittura / v6