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

API de thermostat

L'API Nest fonctionne avec tous les modèles Nest Learning Thermostat™, à l'exception du Thermostat E avec Heat Link dans l'UE.

Les utilisateurs peuvent ajouter plusieurs Nest Thermostats à devices/thermostats groupe, jusqu'à la maximum par la structure . Lorsque vous appelez cet emplacement de données, vous pouvez accéder aux données du thermostat Nest (valeurs de données pour les appareils de la structure).

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

Reference de l'appareil

Identifiant unique du thermostat Nest.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Retour string
Exemple : "peyiJNo0IldT2YlIVtYaGQ"
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

lieu

Spécifie la langue et la région (ou le pays) de préférence.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Retour string
Exemples : "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

une version de logiciel

Une version de logiciel.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Retour string
Exemple : "4.0"
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

id_structure

Identifiant unique de la structure.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Retour string
Exemple : "VqFabWH21nw..."
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

Nom

Nom d'affichage de l'appareil. Peut être n'importe quel nom de pièce d'une liste que nous fournissons, ou un nom personnalisé.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /name
Retour string
Exemple : "Couloir"
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

nom_long

Nom d'affichage long de l'appareil. Comprend une coutume (étiquette), créé par l'utilisateur, ou via wheres .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Retour string
Exemple : « Thermostat de couloir (à l'étage) »
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

dernière_connexion

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

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Retour string
Exemple : "2016-12-31T23:59:59.000Z"
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

est en ligne

État de la connexion de l'appareil au service Nest.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

peut_cool

Capacité du système à refroidir (a AC).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

can_heat

Capacité du système à chauffer.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

is_using_emergency_heat

État de chauffage d'urgence dans les systèmes avec pompes à chaleur pour le refroidissement.

Lorsque le chauffage d'urgence est activé :

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

Voir Quoi de chaleur d' urgence? pour plus d'informations sur la façon dont le thermostat Nest prend en charge le chauffage d'urgence.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

a_fan

Capacité du système à contrôler le ventilateur indépendamment du chauffage ou du refroidissement.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

fan_timer_active

Indique si la minuterie du ventilateur est enclenchée ; utilisé avec fan_timer_duration pour activer le ventilateur pour un paramètre prédéfini (spécifié par l' utilisateur) de durée.

Voir Advanced Control Fan pour plus d' informations sur la façon dont les clients ajuster la durée ventilateur.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Retour boolean
Valeurs : vrai, faux
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

fan_timer_timeout

Timestamp montrant lorsque la minuterie du ventilateur atteint 0 (temps d'arrêt), dans ISO 8601 format.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Retour string
Exemple : "2016-12-31T23:59:59.000Z"
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

a_feuille

Affiché lorsque le thermostat est réglé sur une température d'économie d'énergie.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

temperature_scale

Fahrenheit ou Celsius ; utilisé avec l'affichage de la température.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Retour string enum
Valeurs : "F", "C"
Accès lire écrire
Disponible en Lis:
Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6
Écrivez:
Thermostat lecture/écriture / v5-v6

target_temperature_f

Température désirée, en degrés Fahrenheit (1°F). Utilisé quand hvac_mode = heat ou cool .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Retour number
Exemple : 72
Varier 50-90
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

target_temperature_c

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

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Retour number
Exemple : 21,5
Varier 9-32
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

target_temperature_high_f

Température cible maximale, affichée en degrés entiers Fahrenheit (1°F). Utilisé quand hvac_mode = heat-cool (chaleur • Mode Cool).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Retour number
Exemple : 80
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

target_temperature_high_c

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

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Retour number
Exemple : 24,5
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

target_temperature_low_f

Température cible minimale, affichée en degrés Fahrenheit entiers (1°F). Utilisé quand hvac_mode = heat-cool (chaleur • Mode Cool).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Retour number
Exemple : 65
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

target_temperature_low_c

Température cible minimale, affichée en demi-degrés Celsius (0,5°C). Utilisé quand hvac_mode = heat-cool (chaleur • Mode Cool).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Retour number
Exemple : 19,5
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

eco_temperature_high_f

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

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Retour number
Exemple : 80
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

eco_temperature_high_c

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

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Retour number
Exemple : 24,5
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

eco_temperature_low_f

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

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Retour number
Exemple : 65
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

eco_temperature_low_c

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

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Retour number
Exemple : 19,5
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

away_temperature_high_f (PÉRIMÉ)

Température maximale à l'extérieur, affichée en degrés entiers Fahrenheit (1°F).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Retour number
Exemple : 80
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

away_temperature_high_c (PÉRIMÉ)

Température maximale à l'extérieur, affichée en demi-degrés Celsius (0,5°C).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Retour number
Exemple : 24,5
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

away_temperature_low_f (PÉRIMÉ)

Température minimale à l'extérieur, affichée en degrés entiers Fahrenheit (1°F).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Retour number
Exemple : 65
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

away_temperature_low_c (PÉRIMÉ)

Température d'absence minimale, affichée en demi-degrés Celsius (0,5°C).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Retour number
Exemple : 19,5
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

hvac_mode

Indique les modes de chauffage/refroidissement du système CVC, comme Heat•Cool pour les systèmes avec capacité de chauffage et de refroidissement, ou les températures éco pour les économies d'énergie.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Retour string enum
Valeurs : "chaud", "froid", "chaud-froid", "éco", "off"
Accès lire écrire
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

ambient_temperature_f

Température, mesurée au niveau de l'appareil, en degrés entiers Fahrenheit (1°F).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Retour number
Exemple : 72
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

ambient_temperature_c

Température, mesurée au niveau de l'appareil, en demi-degrés Celsius (0,5°C).

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Retour number
Exemple : 21,5
Accès lecture seulement
Disponible en Lecture du thermostat / v1-v6
Thermostat lecture/écriture / v1-v6

humidité

Humidité, au format pourcentage (%), mesurée au niveau de l'appareil, arrondie au 5 % le plus proche.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Retour number
Exemple : 35
Varier 0-100
Accès lecture seulement
Disponible en Lecture du thermostat / v2-v6
Thermostat lecture/écriture / v2-v6

hvac_state

Indique si le système CVC chauffe, refroidit activement ou est éteint. Utilisez cette valeur pour indiquer l'état de l'activité CVC.

Lorsque off , le système de CVC est pas activement chauffage ou de refroidissement. hvac_state est indépendant du fonctionnement du ventilateur.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Retour string enum
Valeurs : « chauffage », « refroidissement », « arrêt »
Accès lecture seulement
Disponible en Lecture du thermostat / v3-v6
Thermostat lecture/écriture / v3-v6

where_id

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

En savoir plus sur où les noms pour Nest Thermostats ,Nest Protect et Nest en direct .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Retour string
Exemple : "d6reb_OZTM..."
Accès lecture seulement
Disponible en Lecture du thermostat / v4-v6
Thermostat lecture/écriture / v4-v6

est verrouillé

État de verrouillage du thermostat. Lorsque vrai, le verrouillage du locked_temp_min_f locked_temp_max_f locked_temp_min_c locked_temp_max_c thermostat est activée, et limite la plage de température à ces valeurs min / max: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c et locked_temp_max_c .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture du thermostat / v5-v6
Thermostat lecture/écriture / v5-v6

lock_temp_min_f

Minimum de verrouillage du thermostat la température, exprimée en degrés Fahrenheit entiers (1 ° F). Utilisé quand is_locked est true .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Retour string
Exemple : 65
Accès lecture seulement
Disponible en Lecture du thermostat / v5-v6
Thermostat lecture/écriture / v5-v6

lock_temp_max_f

Maximum de verrouillage Thermostat température, exprimée en degrés Fahrenheit entiers (1 ° F). Utilisé quand is_locked est true .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Retour string
Exemple : 80
Accès lecture seulement
Disponible en Lecture du thermostat / v5-v6
Thermostat lecture/écriture / v5-v6

lock_temp_min_c

Minimum de verrouillage Thermostat température, affiché dans affichée en degrés Celsius demi (0,5 ° C). Utilisé quand is_locked est true .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Retour string
Exemple : 19,5
Accès lecture seulement
Disponible en Lecture du thermostat / v5-v6
Thermostat lecture/écriture / v5-v6

lock_temp_max_c

Maximum de verrouillage Thermostat température, affiché dans affichée en degrés Celsius demi (0,5 ° C). Utilisé quand is_locked est true .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Retour string
Exemple : 24,5
Accès lecture seulement
Disponible en Lecture du thermostat / v5-v6
Thermostat lecture/écriture / v5-v6

étiqueter

Thermostat étiquette personnalisée . Apparaît entre parenthèses, après le nom where.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /label
Retour string
Exemples : "A l'étage", "Chambre d'amis", "Salle de jeux"
Accès lire écrire
Disponible en Lis:
Lecture de thermostat / v6
Thermostat lecture/écriture / v6
Écrivez:
Thermostat lecture/écriture / v5-v6

sun_correction_enabled

État d'activation de la crème solaire. Utilisé avec sunlight_correction_active . Lorsque true , la technologie Sunblock est activée, et le thermostat est de régler automatiquement la lumière directe du soleil, la lecture et le réglage de la température.

Pour plus d' informations, voir Qu'est - ce Sunblock?

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

sun_correction_active

Statut actif de la crème solaire. Utilisé avec sunlight_correction_enabled . Lorsque true , indique que le thermostat est situé en plein soleil.

Pour plus d' informations, voir Qu'est - ce Sunblock?

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Retour boolean
Valeurs : vrai, faux
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

where_name

Le nom d'affichage de l'appareil. Associé au thermostat where_id . Peut être n'importe quel nom de pièce d'une liste que nous fournissons ou un nom personnalisé. En savoir plus sur où les noms pour Nest Thermostats ,Nest Protect et Nest en direct .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Retour string
Exemple : "Couloir"
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

fan_timer_duration

Spécifie la durée (en minutes) pendant laquelle le ventilateur est configuré pour fonctionner.

Le fan_timer_active réglage se le ventilateur. La fan_timer_timeout valeur indique l'horodatage lorsque fan_timer_duration est réglé à la fin.

Pour en savoir comment les clients régler la minuterie du ventilateur, voir Durée minuterie .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Retour int
Valeurs : 15, 30, 45, 60, 120, 240, 480, 720
Accès lire écrire
Disponible en Lis:
Lecture de thermostat / v6
Thermostat lecture/écriture / v6
Écrivez:
Thermostat lecture/écriture / v6

time_to_target

Le temps, en minutes, qu'il faudra à la structure pour atteindre la température cible.

Voir Time-to-température pour plus d' informations.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Retour string enum
Valeurs : "~0", "<5", "~15", "~90", "120"
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

time_to_target_training

Lorsqu'il est en mode d'entraînement, le thermostat Nest se renseigne sur le système CVC et découvre combien de temps il faut pour atteindre la température cible. Lorsque le thermostat a suffisamment d' informations pour faire une estimation raisonnable du temps pour atteindre la température cible, cette valeur passe de la training à ready .

Voir Time-to-température pour plus d' informations.

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Retour string enum
Valeurs : "formation", "prêt"
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6

previous_hvac_mode

Affiche le dernier sélectionné hvac_mode . Utilisé lors du passage de hvac_mode = eco sur un appareil avec un microprogramme obsolète.

Pour en savoir plus sur le passage et les modes Eco Situés entre les non-Eco, consultez le Guide du thermostat .

Des détails
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Retour string
Valeurs : "heat", "cool", "heat-cool", "off", vide (aucune valeur)
Accès lecture seulement
Disponible en Lecture de thermostat / v6
Thermostat lecture/écriture / v6