Google is committed to advancing racial equity for Black communities. See how.

API del termostato

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

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

Tutti i valori di seguito si trovano sotto ogni 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

locale

Specifica la lingua e la regione (o paese).

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 Lettura termostato / v1-v6
Lettura/scrittura termostato / 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

id_struttura

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 Lettura termostato / v1-v6
Lettura/scrittura termostato / 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

nome_lungo

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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

ultima_connessione

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

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 Lettura termostato / v1-v6
Lettura/scrittura termostato / 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

can_cool

Capacità del sistema di raffreddare (ha AC).

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

is_using_emergency_heat

Stato di Emergenza Riscaldamento in impianti con pompe di calore per raffrescamento.

Quando il riscaldamento di emergenza è attivo:

  • L'utente può regolare la temperatura target sul dispositivo, ma non può cambiare la modalità fino a quando il riscaldamento di emergenza non viene disattivato
  • Il hvac_mode può ancora essere modificata tramite l'API

Vedi di Cosa calore 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
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

has_fan

Possibilità del sistema di controllare il ventilatore 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

fan_timer_active

Indica se è attivo il timer del ventilatore; utilizzato con fan_timer_duration per accendere il ventilatore per un (specificato dall'utente) periodo predefinito.

Vedere avanzato Fan Control per maggiori informazioni su come i clienti impostare 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

fan_timer_timeout

Timestamp mostra quando il timer arriva a 0 ventola (tempo di arresto), in ISO 8601 formato.

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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

has_leaf

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

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

temperatura_scala

Fahrenheit o Celsius; utilizzato con visualizzazione 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:
Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6
Scrivi:
Lettura/scrittura termostato / v5-v6

target_temperature_f

Temperatura desiderata, in gradi Fahrenheit (1°F). Utilizzato quando hvac_mode = heat o di 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

target_temperature_c

Temperatura desiderata, in mezzi gradi Celsius (0,5°C). Utilizzato quando hvac_mode = heat o di 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

target_temperature_high_f

Temperatura target massima, visualizzata in gradi Fahrenheit interi (1°F). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

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

target_temperature_high_c

Temperatura target massima, visualizzata in mezzi gradi Celsius (0,5 °C). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
ritorna number
Esempio: 24,5
Accesso leggere scrivere
Disponibile in Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

target_temperature_low_f

Temperatura target minima, visualizzata in gradi Fahrenheit interi (1°F). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

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

target_temperature_low_c

Temperatura target minima, visualizzata in mezzi gradi Celsius (0,5 °C). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
ritorna number
Esempio: 19,5
Accesso leggere scrivere
Disponibile in Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

eco_temperature_high_f

Temperatura Eco massima, visualizzata in gradi Fahrenheit interi (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 Lettura termostato / v6
Lettura/scrittura termostato / v6

eco_temperature_high_c

Temperatura Eco massima, visualizzata in mezzi gradi 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 Lettura termostato / v6
Lettura/scrittura termostato / v6

eco_temperature_low_f

Temperatura Eco minima, visualizzata in gradi Fahrenheit interi (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 Lettura termostato / v6
Lettura/scrittura termostato / v6

eco_temperature_low_c

Temperatura Eco minima, visualizzata in mezzi gradi 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 Lettura termostato / v6
Lettura/scrittura termostato / v6

away_temperature_high_f (DEPRECATO)

Temperatura massima esterna, visualizzata in gradi Fahrenheit interi (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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

away_temperature_high_c (DEPRECATO)

Temperatura massima esterna, visualizzata in mezzi gradi 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

away_temperature_low_f (OBBLIGATO)

Temperatura minima esterna, visualizzata in gradi Fahrenheit interi (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 Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

away_temperature_low_c (OBBLIGATO)

Temperatura minima esterna, visualizzata in mezzi gradi 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / 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 Temperature Eco per il risparmio energetico.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
ritorna string enum
Valori: "caldo", "freddo", "caldo-freddo", "eco", "spento"
Accesso leggere scrivere
Disponibile in Lettura termostato / v1-v6
Lettura/scrittura termostato / v1-v6

temperatura_ambiente_f

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

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

temperatura_ambiente_c

Temperatura, misurata sul dispositivo, in mezzi gradi 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 Lettura termostato / v1-v6
Lettura/scrittura termostato / 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 Lettura termostato / v2-v6
Lettura/scrittura termostato / v2-v6

hvac_state

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

Quando off , il sistema HVAC non è attivamente riscaldamento o raffreddamento. hvac_state è indipendente funzionamento del ventilatore.

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

dove_id

Un identificatore univoco del nido generato che rappresenta name , il nome di visualizzazione del dispositivo.

Scopri di più su dove nomi per Termostato Nest ,Nest Protegge e Nest erotiche .

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

è bloccato

Stato di blocco del termostato. Quando vero, il termostato di blocco funzione è abilitata, e limita l'intervallo di temperatura di 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 Lettura termostato / v5-v6
Lettura/scrittura termostato / v5-v6

lock_temp_min_f

Minimo termostato di blocco della temperatura, visualizzata in gradi Fahrenheit interi (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 Lettura termostato / v5-v6
Lettura/scrittura termostato / v5-v6

bloccato_temp_max_f

Massima termostato di blocco della temperatura, visualizzata in gradi Fahrenheit interi (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 Lettura termostato / v5-v6
Lettura/scrittura termostato / v5-v6

lock_temp_min_c

Minimo termostato di blocco della temperatura, visualizzata in visualizzata in gradi Celsius e mezzo (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 Lettura termostato / v5-v6
Lettura/scrittura termostato / v5-v6

bloccato_temp_max_c

Massima termostato Blocco temperatura, indicato in visualizzato in mezzi gradi 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 Lettura termostato / v5-v6
Lettura/scrittura termostato / v5-v6

etichetta

Termostato etichetta personalizzata . Appare tra parentesi, dopo il nome where.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /label
ritorna string
Esempi: "Al piano superiore", "Stanza degli ospiti", "Stanza dei giochi"
Accesso leggere scrivere
Disponibile in Leggere:
Lettura termostato / v6
Lettura/scrittura termostato / v6
Scrivi:
Lettura/scrittura termostato / v5-v6

sun_correction_enabled

Stato di Sunblock abilitato. Utilizzato con sunlight_correction_active . Quando true , tecnologia Sunblock è abilitato, e il termostato sta regolando automaticamente alla luce solare diretta, la lettura e la regolazione della temperatura corretta.

Per ulteriori informazioni, vedere cosa è Sunblock?

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

sun_correction_active

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

Per ulteriori informazioni, vedere cosa è Sunblock?

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

dove_nome

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ù su dove nomi per Termostato Nest ,Nest Protegge e Nest erotiche .

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

fan_timer_duration

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

Il fan_timer_active impostazione si accende il ventilatore. Il fan_timer_timeout valore indica il timestamp quando fan_timer_duration è impostata fine.

Per informazioni su come i clienti di impostare il timer della ventola, vedere Timer Durata .

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:
Lettura termostato / v6
Lettura/scrittura termostato / v6
Scrivi:
Lettura/scrittura termostato / v6

time_to_target

Il tempo, in minuti, che impiegherà la struttura a raggiungere la temperatura target.

Vedere Time-to-temperatura 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 Lettura termostato / v6
Lettura/scrittura termostato / v6

time_to_target_training

Quando è in modalità allenamento, il termostato Nest apprende il 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-temperatura per ulteriori informazioni.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
ritorna string enum
Valori: "formazione", "pronto"
Accesso sola lettura
Disponibile in Lettura termostato / v6
Lettura/scrittura termostato / v6

modalità_hvac_precedente

Consente di visualizzare l'ultimo selezionato hvac_mode . Utilizzato quando si passa dalla hvac_mode = eco su un dispositivo con firmware obsoleto.

Per ulteriori informazioni sul passaggio betwen modalità non-Eco Eco e, consultare la Guida termostato .

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