Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

API du 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 thermostats Nest au groupe d' devices/thermostats , jusqu'à concurrence du maximum par 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.

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 préférence de langue et de région (ou pays).

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.

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

structure_id

Identifiant unique de la structure.

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

Afficher le nom de l'appareil. Il peut s'agir de n'importe quel nom de salle d'une liste que nous fournissons ou d'un nom personnalisé.

Détails
https://developer-api.nest.com/devices/thermostats/ device_id /name
Retour string
Exemple: "Hallway"
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 (étiquette) personnalisée, créée par l'utilisateur ou via des wheres .

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

last_connection

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
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 avec le service Nest.

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

can_cool

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

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.

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 toujours être modifié via l'API

Voir Qu'est-ce que le chauffage d'urgence? pour plus d'informations sur la façon dont le thermostat Nest prend en charge le chauffage d'urgence.

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

has_fan

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

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 engagée; utilisé avec fan_timer_duration pour allumer le ventilateur pendant une durée prédéfinie (spécifiée par l'utilisateur).

Voir Contrôle avancé du ventilateur pour plus d'informations sur la façon dont les clients définissent la durée du ventilateur.

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

Horodatage indiquant lorsque la minuterie du ventilateur atteint 0 (heure d'arrêt), au format ISO 8601 .

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

has_leaf

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

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 affichage de la température.

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
Écrire:
Thermostat lecture / écriture / v5-v6

target_temperature_f

Température souhaitée, en degrés Fahrenheit (1 ° F). Utilisé lorsque hvac_mode = heat or cool .

Détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Retour number
Exemple: 72
Intervalle 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é lorsque hvac_mode = heat or cool .

Détails
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Retour number
Exemple: 21,5
Intervalle 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 Fahrenheit (1 ° F). Utilisé lorsque hvac_mode = heat-cool (mode Heat • Cool).

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é lorsque hvac_mode = heat-cool (mode Heat • Cool).

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 (1 ° F) entiers. Utilisé lorsque hvac_mode = heat-cool (mode Heat • Cool).

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é lorsque hvac_mode = heat-cool (mode Heat • Cool).

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 Fahrenheit (1 ° F) entiers. Utilisé lorsque hvac_mode = eco .

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 du 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é lorsque hvac_mode = eco .

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 du thermostat / v6
Thermostat lecture / écriture / v6

eco_temperature_low_f

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

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 du thermostat / v6
Thermostat lecture / écriture / v6

eco_temperature_low_c

Température éco minimum, 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_low_c
Retour number
Exemple: 19,5
Accès lecture seulement
Disponible en Lecture du thermostat / v6
Thermostat lecture / écriture / v6

away_temperature_high_f (DEPRECATED)

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

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 (DEPRECATED)

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

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 (DEPRECATED)

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

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 (DEPRECATED)

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

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 HVAC, comme Chauffage • Refroidissement pour les systèmes avec capacité de chauffage et de refroidissement, ou Températures éco pour des économies d'énergie.

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

ambient_temperature_f

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

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 sur l'appareil, en demi-degrés Celsius (0,5 ° C).

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 pour cent (%), mesurée sur l'appareil, arrondie aux 5% près.

Détails
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Retour number
Exemple: 35
Intervalle 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 HVAC chauffe, refroidit activement ou est éteint. Utilisez cette valeur pour indiquer l'état d'activité HVAC.

Lorsqu'il est off , le système CVC ne chauffe ou ne refroidit pas activement. hvac_state est indépendant du fonctionnement du ventilateur.

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

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

En savoir plus sur les noms des thermostats Nest , des Nest Protect et des Nest Cam .

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. Lorsqu'elle est vraie, la fonction de verrouillage du 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 .

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

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
Retour string
Exemple: 65
Accès lecture seulement
Disponible en Lecture du thermostat / v5-v6
Thermostat lecture / écriture / v5-v6

lock_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
Retour string
Exemple: 80
Accès lecture seulement
Disponible en Lecture du thermostat / v5-v6
Thermostat lecture / écriture / v5-v6

lock_temp_min_c

Température minimale de verrouillage du thermostat , affichée en demi-degrés Celsius (0,5 ° C). Utilisé lorsque is_locked est true .

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

Température maximale de verrouillage du thermostat , affichée en demi-degrés Celsius (0,5 ° C). Utilisé lorsque is_locked est true .

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

étiquette

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

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 du thermostat / v6
Thermostat lecture / écriture / v6
Écrire:
Thermostat lecture / écriture / v5-v6

correction du soleil_enabled

État activé de la protection solaire. Utilisé avec sunlight_correction_active . Lorsque cela est true , la technologie Sunblock est activée et le thermostat s'adapte automatiquement à la lumière directe du soleil, lisant et réglant la température correcte.

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

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 du thermostat / v6
Thermostat lecture / écriture / v6

correction de la lumière du soleil

Statut actif de l'écran solaire. Utilisé avec la sunlight_correction_enabled de la sunlight_correction_enabled . Lorsqu'elle est true , cela indique que le thermostat est placé en plein soleil.

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

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 du thermostat / v6
Thermostat lecture / écriture / v6

où_nom

Le nom d'affichage de l'appareil. Associé au thermostat where_id . Il peut s'agir de n'importe quel nom de salle d'une liste que nous fournissons ou d'un nom personnalisé. En savoir plus sur les noms des thermostats Nest , des Nest Protect et des Nest Cam .

Détails
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Retour string
Exemple: "Hallway"
Accès lecture seulement
Disponible en Lecture du 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 paramètre fan_timer_active active le ventilateur. La valeur fan_timer_timeout indique l'horodatage lorsque fan_timer_duration est défini sur end.

Pour savoir comment les clients définissent la minuterie du ventilateur, voir Durée de la minuterie .

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 du thermostat / v6
Thermostat lecture / écriture / v6
Écrire:
Thermostat lecture / écriture / v6

time_to_target

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

Voir Temps de température pour plus d'informations.

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 du thermostat / v6
Thermostat lecture / écriture / v6

time_to_target_training

En mode entraînement, le thermostat Nest apprend le système CVC et découvre le temps qu’il faut pour atteindre la température cible. Lorsque le thermostat dispose de suffisamment d'informations pour faire une estimation raisonnable du temps nécessaire pour atteindre la température cible, cette valeur passera de l' training à l'état ready .

Voir Temps de température pour plus d'informations.

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 du thermostat / v6
Thermostat lecture / écriture / v6

previous_hvac_mode

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

Pour en savoir plus sur la commutation entre les modes Eco et non Eco, consultez le Guide du thermostat .

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