Notice: We're retiring Works with Nest. See the home page for more information.
En Google, luchamos por la equidad racial de la comunidad negra. Más información
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

API de termostato

La API de Nest funciona con todos los modelos de Nest Learning Thermostat ™, excepto el Thermostat E con Heat Link en la UE.

Los usuarios pueden agregar varios termostatos Nest al grupo de devices/thermostats , hasta el máximo por estructura . Cuando realiza una llamada a esta ubicación de datos, puede acceder a los datos del termostato Nest (valores de datos para dispositivos en la estructura).

Todos los valores siguientes se encuentran en cada devices/thermostats/ device_id en el documento JSON.

Identificación del dispositivo

Identificador único del termostato Nest.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Devoluciones string
Ejemplo: "peyiJNo0IldT2YlIVtYaGQ"
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

lugar

Especifica la preferencia de idioma y región (o país).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Devoluciones string
Ejemplos: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

Versión del software

Versión del software.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Devoluciones string
Ejemplo: "4.0"
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

structure_id

Identificador único de estructura.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Devoluciones string
Ejemplo: "VqFabWH21nw ..."
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

nombre

Muestra el nombre del dispositivo. Puede ser cualquier nombre de habitación de una lista que proporcionamos o un nombre personalizado.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /name
Devoluciones string
Ejemplo: "Pasillo"
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

name_long

Nombre de visualización largo del dispositivo. Incluye una (etiqueta) personalizada, creada por el usuario o a través de wheres .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Devoluciones string
Ejemplo: "Termostato de pasillo (piso de arriba)"
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

last_connection

Marca de tiempo de la última interacción exitosa con el servicio Nest, en formato ISO 8601 .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Devoluciones string
Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

está en linea

Estado de conexión del dispositivo con el servicio Nest.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

can_cool

Capacidad del sistema para enfriar (tiene aire acondicionado).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

can_heat

Capacidad del sistema para calentar.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

is_using_emergency_heat

Estado de calefacción de emergencia en sistemas con bombas de calor para refrigeración.

Cuando la calefacción de emergencia está encendida:

  • El usuario puede ajustar la temperatura objetivo en el dispositivo, pero no puede cambiar el modo hasta que se apague la calefacción de emergencia.
  • El hvac_mode todavía se puede cambiar a través de la API

Consulte ¿Qué es la calefacción de emergencia? para obtener más información sobre cómo el termostato Nest es compatible con la calefacción de emergencia.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

has_fan

Capacidad del sistema para controlar el ventilador independientemente de la calefacción o la refrigeración.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

fan_timer_active

Indica si el temporizador del ventilador está activado; se utiliza con fan_timer_duration para encender el ventilador durante un período predeterminado (especificado por el usuario).

Consulte 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
Devoluciones boolean
Valores: verdadero, falso
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

fan_timer_timeout

Marca de tiempo que muestra cuando el temporizador del ventilador llega a 0 (tiempo de parada), en formato ISO 8601 .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Devoluciones string
Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

has_leaf

Aparece cuando el termostato está configurado en una temperatura de ahorro de energía.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

la escala de temperatura

Fahrenheit o Celsius; utilizado con pantalla de temperatura.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Devoluciones string enum
Valores: "F", "C"
Acceso leer escribir
Disponible en Leer:
Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6
Escribir:
Termostato lectura / escritura / v5-v6

target_temperature_f

Temperatura deseada, en grados Fahrenheit completos (1 ° F). Se usa cuando hvac_mode = heat o cool .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Devoluciones number
Ejemplo: 72
Rango 50-90
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

target_temperature_c

Temperatura deseada, en medio grado 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
Devoluciones number
Ejemplo: 21,5
Rango 9-32
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

target_temperature_high_f

Temperatura objetivo máxima, mostrada en grados Fahrenheit completos (1 ° F). Se utiliza cuando hvac_mode = heat-cool (modo Heat • Cool).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Devoluciones number
Ejemplo: 80
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

target_temperature_high_c

Temperatura objetivo máxima, mostrada en medio grado Celsius (0,5 ° C). Se utiliza cuando hvac_mode = heat-cool (modo Heat • Cool).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Devoluciones number
Ejemplo: 24,5
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

target_temperature_low_f

Temperatura objetivo mínima, mostrada en grados Fahrenheit (1 ° F) enteros. Se utiliza cuando hvac_mode = heat-cool (modo Heat • Cool).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Devoluciones number
Ejemplo: 65
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

target_temperature_low_c

Temperatura objetivo mínima, mostrada en medio grado Celsius (0,5 ° C). Se utiliza cuando hvac_mode = heat-cool (modo Heat • Cool).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Devoluciones number
Ejemplo: 19,5
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

eco_temperature_high_f

Temperatura Eco máxima, mostrada en grados Fahrenheit (1 ° F) completos. Se usa cuando hvac_mode = eco .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Devoluciones number
Ejemplo: 80
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

eco_temperature_high_c

Temperatura Eco máxima, que se muestra 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_high_c
Devoluciones number
Ejemplo: 24,5
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

eco_temperature_low_f

Temperatura ecológica mínima, que se muestra en grados Fahrenheit (1 ° F) completos. Se usa cuando hvac_mode = eco .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Devoluciones number
Ejemplo: 65
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

eco_temperature_low_c

Temperatura ecológica mínima, que 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_low_c
Devoluciones number
Ejemplo: 19,5
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

away_temperature_high_f (ANULADO)

Temperatura máxima de salida, mostrada en grados Fahrenheit completos (1 ° F).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Devoluciones number
Ejemplo: 80
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

away_temperature_high_c (ANULADO)

Temperatura máxima de salida, mostrada en medio grado Celsius (0,5 ° C).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Devoluciones number
Ejemplo: 24,5
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

away_temperature_low_f (ANULADO)

Temperatura mínima de salida, mostrada en grados Fahrenheit completos (1 ° F).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Devoluciones number
Ejemplo: 65
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

away_temperature_low_c (ANULADO)

Temperatura mínima de salida, mostrada en medio grado Celsius (0,5 ° C).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Devoluciones number
Ejemplo: 19,5
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

hvac_mode

Indica los modos de calefacción / refrigeración del sistema HVAC, como Heat • Cool para sistemas con capacidad de calefacción y refrigeración, o Temperaturas Eco para ahorrar energía.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Devoluciones string enum
Valores: "calor", "frío", "calor-frío", "eco", "apagado"
Acceso leer escribir
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

ambient_temperature_f

Temperatura, medida en el dispositivo, en grados Fahrenheit (1 ° F) enteros.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Devoluciones number
Ejemplo: 72
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

ambient_temperature_c

Temperatura, medida en el dispositivo, en medio grado Celsius (0,5 ° C).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Devoluciones number
Ejemplo: 21,5
Acceso solo lectura
Disponible en Termostato leído / v1-v6
Termostato lectura / escritura / v1-v6

humedad

Humedad, en formato de porcentaje (%), medida en el dispositivo, redondeada al 5% más cercano.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Devoluciones number
Ejemplo: 35
Rango 0-100
Acceso solo lectura
Disponible en Termostato leído / v2-v6
Termostato lectura / escritura / v2-v6

hvac_state

Indica si el sistema HVAC está calentando, enfriando o apagando activamente. Utilice este valor para indicar el estado de actividad de HVAC.

Cuando está off , el sistema HVAC no calienta o enfría activamente. hvac_state es independiente del funcionamiento del ventilador.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Devoluciones string enum
Valores: "calefacción", "refrigeración", "apagado"
Acceso solo lectura
Disponible en Termostato leído / v3-v6
Termostato lectura / escritura / v3-v6

where_id

Un identificador único generado por Nest que representa el name , el nombre para mostrar del dispositivo.

Obtén más información sobre los nombres de los termostatosNest ,Nest Protects y Nest Cams .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Devoluciones string
Ejemplo: "d6reb_OZTM ..."
Acceso solo lectura
Disponible en Termostato leído / v4-v6
Termostato lectura / escritura / 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ínimo / máximo: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c locked_temp_max_c .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v5-v6
Termostato lectura / escritura / v5-v6

lock_temp_min_f

Temperatura mínima de bloqueo del termostato , que se muestra en grados Fahrenheit (1 ° F) completos. Se usa cuando is_locked es true .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Devoluciones string
Ejemplo: 65
Acceso solo lectura
Disponible en Termostato leído / v5-v6
Termostato lectura / escritura / v5-v6

lock_temp_max_f

Temperatura máxima de bloqueo del termostato , que se muestra en grados Fahrenheit (1 ° F) completos. Se usa cuando is_locked es true .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Devoluciones string
Ejemplo: 80
Acceso solo lectura
Disponible en Termostato leído / v5-v6
Termostato lectura / escritura / v5-v6

lock_temp_min_c

Temperatura mínima de bloqueo del termostato , que se muestra en medio grados 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
Devoluciones string
Ejemplo: 19,5
Acceso solo lectura
Disponible en Termostato leído / v5-v6
Termostato lectura / escritura / v5-v6

lock_temp_max_c

Temperatura máxima de bloqueo del termostato , que se muestra en medio grados 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
Devoluciones string
Ejemplo: 24,5
Acceso solo lectura
Disponible en Termostato leído / v5-v6
Termostato lectura / escritura / v5-v6

etiqueta

Etiqueta personalizada del termostato. Aparece entre paréntesis, después del nombre where.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /label
Devoluciones string
Ejemplos: "Arriba", "Habitación de invitados", "Sala de juegos"
Acceso leer escribir
Disponible en Leer:
Termostato leído / v6
Termostato lectura / escritura / v6
Escribir:
Termostato lectura / escritura / v5-v6

luz_del_corrección_enabled

Estado de bloqueador solar activado. Usado con sunlight_correction_active . Cuando es true , la tecnología Sunblock está habilitada y el termostato se ajusta automáticamente a la luz solar directa, leyendo y configurando la temperatura correcta.

Para obtener más información, consulte ¿Qué es el bloqueador solar?

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

luz_de_correccion_activa

Estado activo de bloqueador solar. Se utiliza con sunlight_correction_enabled . Cuando es true , indica que el termostato está expuesto a la luz solar directa.

Para obtener más información, consulte ¿Qué es el bloqueador solar?

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

where_name

El nombre para mostrar del dispositivo. Asociado con el termostato where_id . Puede ser cualquier nombre de habitación de una lista que proporcionamos o un nombre personalizado. Obtén más información sobre los nombres de los termostatosNest ,Nest Protects y Nest Cams .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Devoluciones string
Ejemplo: "Pasillo"
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

fan_timer_duration

Especifica el tiempo (en minutos) que el ventilador está configurado para funcionar.

La configuración fan_timer_active enciende el ventilador. El valor de fan_timer_timeout indica la marca de tiempo cuando fan_timer_duration está configurado para finalizar.

Para saber cómo los clientes configuran el temporizador del ventilador, consulte Duración del temporizador .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Devoluciones int
Valores: 15, 30, 45, 60, 120, 240, 480, 720
Acceso leer escribir
Disponible en Leer:
Termostato leído / v6
Termostato lectura / escritura / v6
Escribir:
Termostato lectura / escritura / v6

time_to_target

El tiempo, en minutos, que le tomará a la estructura alcanzar la temperatura objetivo.

Consulte Tiempo hasta alcanzar la temperatura para obtener más información.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Devoluciones string enum
Valores: "~ 0", "<5", "~ 15", "~ 90", "120"
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

time_to_target_training

Cuando está en modo de entrenamiento, el termostato Nest aprende sobre el sistema HVAC y descubre cuánto tiempo lleva alcanzar la temperatura objetivo. Cuando el termostato tiene suficiente información para hacer una estimación razonable del tiempo para alcanzar la temperatura objetivo, este valor cambiará de training a ready .

Consulte Tiempo hasta alcanzar la temperatura para obtener más información.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Devoluciones string enum
Valores: "formación", "listo"
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6

previous_hvac_mode

Muestra el hvac_mode seleccionado por última hvac_mode . Se utiliza cuando se cambia de hvac_mode = eco en un dispositivo con firmware desactualizado.

Para obtener más información sobre cómo cambiar entre los modos Eco y no Eco, consulte la Guía del termostato .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Devoluciones string
Valores: "calor", "frío", "calor-frío", "apagado", en blanco (sin valor)
Acceso solo lectura
Disponible en Termostato leído / v6
Termostato lectura / escritura / v6