API de Thermostat

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 ni target_temperature_c si hvac_mode = off o eco

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