API de thermostat

L'API Nest est compatible avec tous les modèles Nest Learning ThermostatTM, à l'exception de ceux qui sont équipés du Heat Link dans l'UE.

Les utilisateurs peuvent ajouter plusieurs thermostats Nest au groupe devices/thermostats, dans la limite maximale par structure. Lorsque vous appelez cet emplacement de données, vous pouvez accéder aux données du thermostat Nest (valeurs des données des appareils de la structure).

Toutes les valeurs ci-dessous se trouvent sous chaque devices/thermostats/device_id du document JSON.

device_id [id_appareil]

Identifiant unique du thermostat Nest.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/device_id
Renvoiestring
Exemple: "peyiJNo0IldT2YlIVtYaGQ"
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

locale

Spécifie la langue et la région (ou le pays).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/locale
Renvoiestring
Exemples: "fr-FR", "fr-FR", "es-FR", "fr-CA", "fr-CA", "nl-NL"
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

version_logicielle

Version du logiciel

Détails
https://developer-api.nest.com/devices/thermostats/device_id/software_version
Renvoiestring
Exemple: "4.0"
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

structure_id [id_structure]

Identifiant unique de la structure.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
Renvoiestring
Exemple: "VqFabWH21nw..."
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

nom

Nom à afficher de l'appareil. Il peut s'agir de n'importe quel nom de chambre issu d'une liste que nous fournissons ou d'un nom personnalisé.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/name
Renvoiestring
Exemple: "Couloir"
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

nom_long

Nom à afficher de l'appareil. Inclut un (libellé) personnalisé, créé par l'utilisateur ou via wheres.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/name_long
Renvoiestring
Exemple: "Thermostat d'entrée (étage)"
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

dernière connexion

Horodatage de la dernière interaction réussie avec le service Nest, au format ISO 8601.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/last_connection
Renvoiestring
Exemple: "2016-12-31T23:59:59.000Z"
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

est_en ligne

État de connexion de l'appareil avec le service Nest.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/is_online
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

can_cool

Climatisation du système (clim).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/can_cool
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

can_heat

Capacité du système à chauffer

Détails
https://developer-api.nest.com/devices/thermostats/device_id/can_heat
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

is_using_emergency_heat

État du chauffage d'urgence dans les systèmes équipés de pompes à chaleur pour la climatisation.

Lorsque le chauffage d'urgence est allumé:

  • L'utilisateur peut régler la température de consigne sur l'appareil, mais ne peut pas modifier le mode tant que le chauffage d'urgence n'est pas désactivé
  • Le hvac_mode peut toujours être modifié via l'API

Pour plus d'informations sur la compatibilité du thermostat Nest avec le chauffage d'urgence, consultez la page Qu'est-ce que le chauffage d'urgence ?

Détails
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

a_ventilateur

Possibilité pour le système de contrôler le ventilateur indépendamment du chauffage ou de la climatisation

Détails
https://developer-api.nest.com/devices/thermostats/device_id/has_fan
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

fan_timer_active

Indique si le minuteur du ventilateur est en marche. utilisé avec fan_timer_duration pour allumer le ventilateur pendant une durée prédéfinie (utilisateur)

Consultez la page sur le contrôle avancé des ventilateurs pour en savoir plus sur la manière dont les clients définissent la durée des ventilateurs.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
Renvoieboolean
Valeurs: true, false
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

fan_timer_timeout

Horodatage de l'affichage de 0 (heure d'arrêt) sur le ventilateur, au format ISO 8601.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout
Renvoiestring
Exemple: "2016-12-31T23:59:59.000Z"
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

a_Feuille

S'affiche lorsque le thermostat est réglé sur une température permettant de faire des économies d'énergie.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

température_scale

Fahrenheit ou Celsius avec affichage de la température.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale
Renvoiestring enum
Valeurs: "F", "C"
Accèslecture/écriture
Disponible dansLecture:
Lecture du thermostat / v1-v6
Lecture/Écriture du thermostat / v1-v6
Écriture:
Lecture du thermostat/écriture / v5-v6

target_temperature_f [température_de_température_cible]

Température souhaitée, en degrés Fahrenheit. Utilisé lorsque hvac_mode = heat ou cool.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f
Renvoienumber
Exemple: 72
Plage50-90
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

target_temperature_c (température_cible_température)

Température souhaitée, en demi-degrés Celsius (0,5 °C). Utilisé lorsque hvac_mode = heat ou cool.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c
Renvoienumber
Exemple: 21,5
Plage9-32
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

target_temperature_high_f [température_élevée_cible]

Température cible maximale, affichée en degrés Fahrenheit (1 °F). Utilisé lorsque hvac_mode = heat-cool (Chauff. • Clim.).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f
Renvoienumber
Exemple: 80
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

target_temperature_high_c (température_élevée_cible)

Température cible maximale, affichée en demi-degrés Celsius (0,5 °C). Utilisé lorsque hvac_mode = heat-cool (Chauffage • Mode Climatisation).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c
Renvoienumber
Exemple: 24,5
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

target_temperature_low_f [objectif_température_faible]

Température de consigne minimale, exprimée en degrés Fahrenheit (1 °F). Utilisé lorsque hvac_mode = heat-cool (Chauff. • Clim.).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f
Renvoienumber
Exemple: 65
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

target_temperature_low_c [température_température_faible]

Température de consigne minimale, affichée à 0,5 °C. Utilisé lorsque hvac_mode = heat-cool (Chauffage • Mode Climatisation).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c
Renvoienumber
Exemple: 19.5
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

température_éco_élevée_f

Température éco maximale, affichée en degrés Fahrenheit (1 °F). Utilisé lorsque hvac_mode = eco.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
Renvoienumber
Exemple: 80
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

température_éco_élevée_c

Température éco maximale, affichée en demi-degrés Celsius (0,5 °C). Utilisé lorsque hvac_mode = eco.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
Renvoienumber
Exemple: 24,5
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

eco_température_faible

Température éco minimale, affichée en degrés Fahrenheit (1 °F). Utilisé lorsque hvac_mode = eco.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
Renvoienumber
Exemple: 65
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

eco_température_faible

Température éco minimale, affichée à 0,5 °C. Utilisé lorsque hvac_mode = eco.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c
Renvoienumber
Exemple: 19.5
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

absent_temperature_high_f (OBSOLDETE)

Température maximale d'absence, affichée en degrés Fahrenheit (1°F).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f
Renvoienumber
Exemple: 80
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

away_temperature_high_c (OBSOL)TE)

Température d'absence maximale, affichée à 0,5 °C.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c
Renvoienumber
Exemple: 24,5
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

away_temperature_low_f (OBSOLDETE)

Température d'absence minimale, affichée en degrés Fahrenheit (1 °F).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f
Renvoienumber
Exemple: 65
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

away_temperature_low_c (OBSOL)TE)

Température d'absence minimale, affichée à 0,5 °C.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
Renvoienumber
Exemple: 19.5
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

hvac_mode

Indique les modes de chauffage/climatisation du système CVC (chauffage/climatisation, par exemple) pour les systèmes dotés d'une capacité de chauffage et de climatisation, ou la température éco pour les économies d'énergie.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
Renvoiestring enum
Valeurs: "chauffage", "climatisation", "chauffage/climatisation", "éco", "désactivé"
Accèslecture/écriture
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

température_ambiante

Température, mesurée à l'appareil, en degrés Fahrenheit (1 °F).

Détails
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
Renvoienumber
Exemple: 72
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

Ambiance_température_c

Température, mesurée à l'appareil, à 0,5 °C.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c
Renvoienumber
Exemple: 21,5
Accèslecture seule
Disponible dansThermostat (lecture / v1-v6)
Thermostat lecture/écriture / v1-v6

humidité

Humidité, exprimée en pourcentage (%), mesurée à l'appareil et arrondie au 5 % le plus proche.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/humidity
Renvoienumber
Exemple: 35
Plage0–100
Accèslecture seule
Disponible dansThermostat (lecture / v2-v6)
Thermostat lecture/écriture / v2-v6

hvac_state

Indique si le système CVC est en cours de chauffage, de climatisation ou éteint. Cette valeur permet d'indiquer l'état du système CVC.

Lorsque off, le système CVC n'est pas en mode Chauffage ou Climatisation actif. hvac_state est indépendant du fonctionnement du ventilateur.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state
Renvoiestring enum
Valeurs: "chauffage", "climatisation", "désactivé"
Accèslecture seule
Disponible dansThermostat (lecture / v3-v6)
Thermostat lecture/écriture / v3-v6

Où_ID

Identifiant unique généré par Nest, qui représente name, le nom d'affichage de l'appareil.

En savoir plus sur l'emplacement des thermostats Nest, des Nest Protect et des Nest Cam

Détails
https://developer-api.nest.com/devices/thermostats/device_id/where_id
Renvoiestring
Exemple: "d6reb_OZTM..."
Accèslecture seule
Disponible dansThermostat (lecture / v4-v6)
Thermostat lecture/écriture / v4-v6

est_verrouillé

État du verrouillage du thermostat. Lorsque la valeur est "true", la fonctionnalité de verrouillage du thermostat est activée et limite la plage de températures aux valeurs minimales/maximales : locked_temp_min_f, locked_temp_max_f, locked_temp_min_c et locked_temp_max_c.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/is_locked
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat (lecture / v5-v6)
Thermostat lecture/écriture / v5-v6

verrouillé_temp_min_f

Température minimale de verrouillage du thermostat, affichée en degrés Fahrenheit (1 °F). Utilisé lorsque is_locked est true.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f
Renvoiestring
Exemple: 65
Accèslecture seule
Disponible dansThermostat (lecture / v5-v6)
Thermostat lecture/écriture / v5-v6

verrouillé_temp_max_f

Température maximale de verrouillage du thermostat, affichée en degrés Fahrenheit (1 °F). Utilisé lorsque is_locked est true.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
Renvoiestring
Exemple: 80
Accèslecture seule
Disponible dansThermostat (lecture / v5-v6)
Thermostat lecture/écriture / v5-v6

verrouillé_temp_min_c

Température minimale de verrouillage du thermostat, affichée en deux degrés (0,5°C). Utilisé lorsque is_locked est défini sur true.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
Renvoiestring
Exemple: 19.5
Accèslecture seule
Disponible dansThermostat (lecture / v5-v6)
Thermostat lecture/écriture / v5-v6

verrouillé_temp_max_c

Température maximale du thermostat, affichée à 0,5 °C en demi-degrés Celsius. Utilisé lorsque is_locked est défini sur true.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
Renvoiestring
Exemple: 24,5
Accèslecture seule
Disponible dansThermostat (lecture / v5-v6)
Thermostat lecture/écriture / v5-v6

étiquette

Libellé personnalisé du thermostat. Apparaît entre parenthèses, après le nom où.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/label
Renvoiestring
Exemples: "À l'étage", "Chambre", "Salle de jeux"
Accèslecture/écriture
Disponible dansLecture:
Lecture/Écriture du thermostat v6
Lecture/Écriture du thermostat v6
Écriture:
Lecture/Écriture du thermostat / v5 -v6

sun_correction_enabled

État d'activation de la fonctionnalité Pare-soleil. Utilisé avec sunlight_correction_active. Lorsque true est activé, la technologie Pare-soleil est activée, et le thermostat s'adapte automatiquement à la lumière directe du soleil pour lire et régler la température adéquate.

Consultez la page Qu'est-ce que le Pare-soleil ? pour en savoir plus.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

soleil_correction_active

État actif de la fonctionnalité Pare-soleil. Utilisé avec sunlight_correction_enabled. Lorsque true indique que le thermostat est exposé à la lumière directe du soleil.

Consultez la page Qu'est-ce que le Pare-soleil ? pour en savoir plus.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
Renvoieboolean
Valeurs: true, false
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

où_nom

Nom à afficher de l'appareil. Associé au thermostat where_id. Il peut s'agir de n'importe quel nom de chambre issu d'une liste que nous fournissons ou d'un nom personnalisé. En savoir plus sur l'emplacement des thermostats Nest, des Nest Protect et des Nest Cam

Détails
https://developer-api.nest.com/devices/thermostats/device_id/where_name
Renvoiestring
Exemple: "Couloir"
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

fan_timer_duration

Permet de spécifier la durée (en minutes) pendant laquelle le ventilateur est allumé.

Le paramètre fan_timer_active allume le ventilateur. La valeur fan_timer_timeout indique l'horodatage lorsque fan_timer_duration est défini sur la fin.

Pour savoir comment les clients définissent le minuteur du ventilateur, consultez la section Durée du minuteur.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration
Renvoieint
Valeurs: 15, 30, 45, 60, 120, 240, 480, 720
Accèslecture/écriture
Disponible dansLecture:
Lecture/Écriture du thermostat v6
Lecture/Écriture du thermostat v6
Écriture:
Lecture/Écriture du thermostat / v6

temps_de_cible

Temps nécessaire à la structure pour atteindre la température cible, en minutes.

Pour en savoir plus, consultez la section Délai température.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target
Renvoiestring enum
Valeurs: "~0", "<5", "~15", "~90", "120"
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

time_to_target_training (temps_d'entraînement_cible)

En mode entraînement, le thermostat Nest analyse le système CVC et détecte le temps nécessaire pour atteindre la température de consigne. Lorsque le thermostat dispose d'une information suffisante pour fournir une estimation raisonnable de la durée nécessaire pour atteindre la température de consigne, cette valeur passe de training à ready.

Pour en savoir plus, consultez la section Délai température.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
Renvoiestring enum
Valeurs: "training", "ready"
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6

mode_hvac_précédent

Affiche le dernier élément sélectionné : hvac_mode. Utilisé lorsque vous passez de hvac_mode = eco sur un appareil dont le micrologiciel est obsolète.

Pour savoir comment passer d'un mode à l'autre, consultez le guide du thermostat.

Détails
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
Renvoiestring
Valeurs: "chauffage", "climatisation", "chauffage/climatisation", "désactivé", vide (aucune valeur)
Accèslecture seule
Disponible dansThermostat : lecture / v6
Thermostat lecture/écriture / v6