La API de Nest funciona con todos los modelos de Nest Learning ThermostatTM, excepto el Nest Thermostat E con Heat Link en la UE.
Los usuarios pueden agregar varios termostatos Nest al grupo devices/thermostats
, hasta el máximo por estructura.
Cuando haces una llamada a esta ubicación de datos, puedes acceder a los datos del Nest Thermostat (valores de datos para los dispositivos en la estructura).
Todos los valores que se muestran a continuación se encuentran en cada devices/thermostats/device_id
del documento JSON.
id_dispositivo
Identificador único del Termostato Nest.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/device_id |
|
Qué muestra | string Ejemplo: “peyiJNo0IldT2YlIVtYaGQ” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
configuración regional
Especifica la preferencia de idioma y región (o país).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locale |
|
Qué muestra | string Ejemplos: “en-GB”, “en-US”, “es-US”, “fr-CA”, “fr-CA” o “nl-NL” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
versión_de_software
Versión de software.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/software_version |
|
Qué muestra | string Ejemplo: “4.0” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
ID_estructura
Identificador único de la estructura.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/structure_id |
|
Qué muestra | string Ejemplo: “VqFabWH21nw...” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
name
Nombre visible del dispositivo. Puede ser cualquier nombre de sala de una lista que proporcionamos, o un nombre personalizado.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/name |
|
Qué muestra | string Ejemplo: "Pasillo" |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
nombre_largo
Nombre visible largo del dispositivo. Incluye una personalizada (etiqueta), creada por el usuario, o a través de wheres
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/name_long |
|
Qué muestra | string Ejemplo: "Termostato del pasillo (planta alta)" |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
última_conexión
Marca de tiempo de la última interacción exitosa con el servicio de Nest, en formato ISO 8601.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/last_connection |
|
Qué muestra | string Ejemplo: “2016-12-31T23:59:59.000Z” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
está_en línea
Estado de conexión del dispositivo con el servicio de Nest.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/is_online |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
cano frío
Capacidad del sistema de enfriamiento (tiene aire acondicionado).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/can_cool |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
can_heat
Capacidad del sistema para calefaccionar
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/can_heat |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
is_using_emergency_heat
Estado del calefactor de emergencia en sistemas con bombas de calor para enfriamiento
Cuando el calefactor de emergencia está activado:
- El usuario puede ajustar la temperatura final en el dispositivo, pero no puede cambiar el modo hasta que se apague el calefactor de emergencia.
- Aún se puede cambiar
hvac_mode
a través de la API
Consulta ¿Qué es el calefactor de emergencia? para obtener más información sobre cómo el Termostato Nest admite el calefactor de emergencia.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
tiene_ventilador
Es la capacidad del sistema para controlar el ventilador de manera independiente de la calefacción o el enfriamiento.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/has_fan |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
ventilador_tiempo_activo
Indica si el temporizador del ventilador está activado; se usa con fan_timer_duration
para encender el ventilador durante un período predeterminado (especificado por el usuario).
Consulta la sección sobre el control avanzado del ventilador para obtener más información sobre cómo los clientes establecen la duración del ventilador.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
tiempo_tiempo_en_fan
Marca de tiempo que muestra cuándo el temporizador del ventilador llega a 0 (tiempo de detención), en formato ISO 8601.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout |
|
Qué muestra | string Ejemplo: “2016-12-31T23:59:59.000Z” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
tiene_hoja
Aparece cuando el termostato está configurado en una temperatura que ahorra energía.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
escala_temperatura
Fahrenheit o Celsius; se usa con pantalla de temperatura.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale |
|
Qué muestra | string enum Valores: "F", "C" |
Acceso | Lectura y escritura |
Disponible en | Lectura: Lectura/termostato/v1-v6 Lectura/escritura del termostato/v1-v6 Escritura: Lectura/escritura del termostato/v5-v6 |
temperatura_objetivo_f
Temperatura deseada en grados Fahrenheit (1 °F) completos Se usa cuando hvac_mode
= heat
o cool
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f |
|
Qué muestra | number Ejemplo: 72 |
Intervalo | 50-90 |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
temperatura_objetivo_c
Temperatura deseada en media grados Celsius (0.5 °C) Se usa cuando hvac_mode
= heat
o cool
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c |
|
Qué muestra | number Ejemplo: 21.5 |
Intervalo | 9-32 |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
temperatura_objetivo_alta_f
Temperatura final máxima, expresada en grados enteros Fahrenheit (1°F).
Se usa cuando hvac_mode
= heat-cool
(modo Calor • Frío).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f |
|
Qué muestra | number Ejemplo: 80 |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
temperatura_objetivo_alta_c
Temperatura final máxima, mostrada en medio grados Celsius (0.5 °C). Se usa cuando hvac_mode
= heat-cool
(modo Calor • Frío).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c |
|
Qué muestra | number Ejemplo: 24.5 |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
temperatura_objetivo_baja_f
Temperatura final mínima, expresada en grados enteros Fahrenheit (1°F).
Se usa cuando hvac_mode
= heat-cool
(modo Calor • Frío).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f |
|
Qué muestra | number Ejemplo: 65 |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
temperatura_objetivo_baja_c
Temperatura mínima mínima, mostrada en medio grados Celsius (0.5 °C). Se usa cuando hvac_mode
= heat-cool
(modo Calor • Frío).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c |
|
Qué muestra | number Ejemplo: 19.5 |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
eco_temperatura_alta_f
La temperatura Eco máxima se muestra en grados enteros Fahrenheit (1 °F). Se usa cuando hvac_mode
= eco
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f |
|
Qué muestra | number Ejemplo: 80 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
eco_temperatura_alta_c
La temperatura máxima Eco se muestra en medio grado Celsius (0.5 °C). Se usa cuando hvac_mode
= eco
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c |
|
Qué muestra | number Ejemplo: 24.5 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
eco_temperatura_baja_f
La temperatura Eco mínima se muestra en grados enteros Fahrenheit (1 °F). Se usa cuando hvac_mode
= eco
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f |
|
Qué muestra | number Ejemplo: 65 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
eco_temperatura_baja_c
Temperatura Eco mínima, mostrada en medio grados Celsius (0.5 °C). Se usa cuando hvac_mode
= eco
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c |
|
Qué muestra | number Ejemplo: 19.5 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
Ausente_temperatura_alta_f (OBSOLETA)
Temperatura máxima de distancia, mostrada en grados enteros Fahrenheit (1 °F).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f |
|
Qué muestra | number Ejemplo: 80 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
Ausente_temperatura_alta_c (OBSOLETO)
Temperatura máxima de distancia, mostrada en medio grados Celsius (0.5 °C).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c |
|
Qué muestra | number Ejemplo: 24.5 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
Ausente_temperatura_baja_f (OBSOLETA)
Temperatura mínima de distancia, mostrada en grados enteros Fahrenheit (1°F).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f |
|
Qué muestra | number Ejemplo: 65 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
Ausente_temperatura_baja_c (OBSOLETA)
Temperatura mínima de distancia, mostrada en medio grados Celsius (0.5 °C).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c |
|
Qué muestra | number Ejemplo: 19.5 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
Modo HVCAC
Indica los modos de calefacción y enfriamiento de sistemas de HVAC, como Calor • Frío para sistemas con capacidad de calefacción y enfriamiento, o Temperaturas Eco para ahorrar energía.
hvac_mode
se puede cambiar si el termostato está bloqueado- No se puede cambiar
target_temperature_f
nitarget_temperature_c
sihvac_mode
=off
oeco
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode |
|
Qué muestra | string enum Valores: "calor", "frío", "calentamiento-frío", "eco", "apagado" |
Acceso | Lectura y escritura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
ambiente_temperatura_f
Temperatura, medida en el dispositivo, en grados enteros Fahrenheit (1°F).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f |
|
Qué muestra | number Ejemplo: 72 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
ambiente_temperatura_c
Es la temperatura que se mide en el dispositivo, en medio grado Celsius (0.5 °C).
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c |
|
Qué muestra | number Ejemplo: 21.5 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v1-v6 Lectura/escritura del termostato / v1-v6 |
humedad
Humedad, en porcentaje (%), medida en el dispositivo, redondeada al 5% más cercano.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/humidity |
|
Qué muestra | number Ejemplo: 35 |
Intervalo | 0-100 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v2-v6 Lectura/escritura del termostato / v2-v6 |
estado_hvac
Indica si el sistema de HVAC está calefaccionando, enfriando o apagando. Usa este valor para indicar el estado de la actividad de HVAC.
Cuando off
, el sistema de HVAC no está calefaccionando ni enfriando de forma activa. hvac_state
es independiente de la operación del ventilador.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state |
|
Qué muestra | string enum Valores: "calefacción", "enfriamiento", "apagado" |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v3-v6 Lectura/escritura del termostato / v3-v6 |
where_id [id_lugar]
Un identificador único generado por Nest que representa name
, el nombre visible del dispositivo.
Obtén más información sobre los nombres de los termostatos Nest, los Nest Protects y las Nest Cams.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/where_id |
|
Qué muestra | string Ejemplo: “d6reb_OZTM...” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v4-v6 Lectura/escritura del termostato / v4-v6 |
está_bloqueado
Estado de bloqueo del termostato. Cuando es verdadero, la función de Bloqueo del termostato está habilitada y restringe el rango de temperatura a estos valores mínimos y máximos: locked_temp_min_f
, locked_temp_max_f
, locked_temp_min_c
y locked_temp_max_c
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/is_locked |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v5-v6 Lectura/escritura del termostato / v5-v6 |
bloqueo_temp_min_f
Temperatura mínima del Bloqueo del termostato, que se muestra en grados enteros Fahrenheit (1 °F). Se usa cuando is_locked
es true
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f |
|
Qué muestra | string Ejemplo: 65 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v5-v6 Lectura/escritura del termostato / v5-v6 |
bloqueo_temp_máx_f
Temperatura máxima de Bloqueo del termostato, que se muestra en grados enteros Fahrenheit (1 °F). Se usa cuando is_locked
es true
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f |
|
Qué muestra | string Ejemplo: 80 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v5-v6 Lectura/escritura del termostato / v5-v6 |
bloqueo_temp_min_c
Temperatura mínima del Bloqueo del termostato, que se muestra en medio grado Celsius (0.5 °C). Se usa cuando is_locked
es true
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c |
|
Qué muestra | string Ejemplo: 19.5 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v5-v6 Lectura/escritura del termostato / v5-v6 |
bloqueo_temp_máx
Temperatura máxima de Bloqueo del termostato, que se muestra en medio grado Celsius (0.5 °C). Se usa cuando is_locked
es true
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c |
|
Qué muestra | string Ejemplo: 24.5 |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v5-v6 Lectura/escritura del termostato / v5-v6 |
label
Etiqueta personalizada del termostato Aparece entre paréntesis después del nombre del lugar.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/label |
|
Qué muestra | string Ejemplos: "Planta alta", "Habitación de huéspedes", "Sala de juegos" |
Acceso | Lectura y escritura |
Disponible en | Lectura: Lectura/termostato/v6 Lectura/escritura del termostato/v6 Escritura: Lectura/escritura del termostato/v5-v6 |
corrección_de_luz
Estado Bloqueador solar. Se usa con sunlight_correction_active
.
Cuando la función true
está habilitada, la tecnología Bloqueador solar está habilitada y el termostato se ajusta automáticamente a la luz solar directa, lo que permite leer y establecer la temperatura correcta.
Para obtener más información, consulta ¿Qué es el Bloqueador solar?
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
Corrección de luz solar
Bloqueador solar en estado activo. Se usa con sunlight_correction_enabled
.
Cuando el valor es true
, indica que el Termostato se encuentra bajo luz solar directa.
Para obtener más información, consulta ¿Qué es el Bloqueador solar?
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active |
|
Qué muestra | boolean Valores: verdadero, falso |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
dónde_nombre
El nombre visible del dispositivo. Asociada con el termostato where_id
. Puede ser cualquier nombre de sala de una lista que proporcionamos, o un nombre personalizado. Obtén más información sobre los nombres de los termostatos Nest, los Nest Protects y las Nest Cams.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/where_name |
|
Qué muestra | string Ejemplo: "Pasillo" |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
duración_del_fanático
Especifica el período (en minutos) que el ventilador está configurado para funcionar.
La configuración de fan_timer_active
enciende el ventilador. El valor fan_timer_timeout
indica la marca de tiempo cuando se configura fan_timer_duration
para terminar.
Para obtener información sobre cómo los clientes configuran el temporizador del ventilador, consulta Duración del temporizador.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration |
|
Qué muestra | int Valores: 15, 30, 45, 60, 120, 240, 480, 720 |
Acceso | Lectura y escritura |
Disponible en | Lectura: Lectura/termostato/v6 Lectura/escritura del termostato/v6 Escritura: Lectura/escritura del termostato/v6 |
tiempo_para_objetivo
El tiempo, en minutos, que tardará la estructura en alcanzar la temperatura final.
Consulta Tiempo para temperatura para obtener más información.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target |
|
Qué muestra | string enum Valores: "~0", "<5", "~15", "~90", "120" |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
tiempo_para_la_capacitación_objetivo
Cuando está en modo de entrenamiento, el Nest Thermostat aprende sobre el sistema de HVAC y descubre cuánto tiempo tarda en alcanzar la temperatura final. Cuando el termostato tenga suficiente información para hacer una estimación razonable del tiempo que alcanza para alcanzar la temperatura final, este valor cambiará de training
a ready
.
Consulta Tiempo para temperatura para obtener más información.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training |
|
Qué muestra | string enum Valores: “entrenamiento”, “listo” |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |
modo_hvac anterior
Muestra la última selección de hvac_mode
. Se usa cuando se cambia de hvac_mode
= eco
en un dispositivo con firmware desactualizado.
Para obtener más información sobre cómo alternar entre los modos Eco y no Eco, consulta la Guía del termostato.
Detalles | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode |
|
Qué muestra | string Valores: "calor", "frío", "calentamiento-frío", "apagado", en blanco (sin valores) |
Acceso | solo lectura |
Disponible en | Lectura del termostato / v6 Lectura/escritura del termostato / v6 |