Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

API de termostato

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

Los usuarios pueden agregar múltiples 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 a continuación se encuentran debajo de cada devices/thermostats/ device_id en el documento JSON.

ID 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

lugar

Especifica el idioma y la preferencia de 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 de lectura / v1-v6
Termostato de 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

estructura_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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

nombre

Nombre para mostrar 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
Devoluciones string
Ejemplo: "Pasillo"
Acceso solo lectura
Disponible en Termostato de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

nombre_largo

Nombre largo para mostrar del dispositivo. Incluye una (etiqueta) personalizada, creada por el usuario, o vía wheres .

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

última_conexión

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 de lectura / v1-v6
Termostato de 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

can_cool

Capacidad del sistema para enfriarse (tiene AC).

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

puede calentar

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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

is_using_emergency_heat

Estado de calor de emergencia en sistemas con bombas de calor para enfriamiento.

Cuando el calor de emergencia está activado:

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

Vea ¿Qué es el calor de emergencia? para obtener más información sobre cómo Nest Thermostat admite el calor 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

has_fan

Capacidad del sistema para controlar el ventilador independientemente del calentamiento o enfriamiento.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato de lectura / v1-v6
Termostato de 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 una duración predeterminada (especificada por el usuario).

Consulte Control avanzado de ventiladores 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

fan_timer_timeout

Marca de tiempo que muestra cuando el temporizador del ventilador alcanza 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

has_leaf

Aparece cuando el termostato está configurado a 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

la escala de temperatura

Fahrenheit o Celsius; Se utiliza con la 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6
Escribir:
Termostato de lectura / escritura / v5-v6

target_temperature_f

Temperatura deseada, en grados completos Fahrenheit (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 de lectura / v1-v6
Termostato de 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

target_temperature_high_f

Temperatura objetivo máxima, mostrada en grados enteros Fahrenheit (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 de lectura / v1-v6
Termostato de 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

target_temperature_low_f

Temperatura objetivo mínima, mostrada en grados enteros Fahrenheit (1 ° F). 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 de lectura / v1-v6
Termostato de 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

eco_temperature_high_f

Temperatura ecológica máxima, mostrada 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
Devoluciones number
Ejemplo: 80
Acceso solo lectura
Disponible en Termostato de lectura / v6
Termostato de lectura / escritura / v6

eco_temperature_high_c

Temperatura ecológica máxima, 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_high_c
Devoluciones number
Ejemplo: 24,5
Acceso solo lectura
Disponible en Termostato de lectura / v6
Termostato de lectura / escritura / v6

eco_temperature_low_f

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

eco_temperature_low_c

Temperatura ecológica mínima, mostrada 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 de lectura / v6
Termostato de lectura / escritura / v6

away_temperature_high_f (DEPRECATED)

Temperatura máxima de distancia, que se muestra en grados enteros Fahrenheit (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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

away_temperature_high_c (DEPRECATED)

Temperatura máxima de distancia, 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

away_temperature_low_f (DEPRECATED)

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
Devoluciones number
Ejemplo: 65
Acceso solo lectura
Disponible en Termostato de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

away_temperature_low_c (DEPRECATED)

Temperatura mínima de distancia, 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

hvac_mode

Indica modos de calefacción / refrigeración del sistema HVAC, como Heat • Cool para sistemas con capacidad de calefacción y refrigeración, o Eco Temperatures 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 de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

temperatura_ambiente_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
Devoluciones number
Ejemplo: 72
Acceso solo lectura
Disponible en Termostato de lectura / v1-v6
Termostato de lectura / escritura / v1-v6

temperatura_ambiente_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 de lectura / v1-v6
Termostato de 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 de lectura / v2-v6
Termostato de lectura / escritura / v2-v6

hvac_state

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

Cuando está off , el sistema HVAC no calienta ni 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: "calentamiento", "enfriamiento", "apagado"
Acceso solo lectura
Disponible en Termostato de lectura / v3-v6
Termostato de 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 dónde están los nombres de los termostatos Nest , 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 de lectura / v4-v6
Termostato de 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 locked_temp_min_f / 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
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Termostato de lectura / v5-v6
Termostato de lectura / escritura / v5-v6

locked_temp_min_f

Temperatura mínima 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_min_f
Devoluciones string
Ejemplo: 65
Acceso solo lectura
Disponible en Termostato de lectura / v5-v6
Termostato de lectura / escritura / v5-v6

locked_temp_max_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
Devoluciones string
Ejemplo: 80
Acceso solo lectura
Disponible en Termostato de lectura / v5-v6
Termostato de lectura / escritura / v5-v6

locked_temp_min_c

Temperatura mínima de bloqueo del termostato , mostrada en mostrada 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
Devoluciones string
Ejemplo: 19.5
Acceso solo lectura
Disponible en Termostato de lectura / v5-v6
Termostato de lectura / escritura / v5-v6

locked_temp_max_c

Temperatura máxima de bloqueo del termostato , mostrada en mostrada 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
Devoluciones string
Ejemplo: 24,5
Acceso solo lectura
Disponible en Termostato de lectura / v5-v6
Termostato de 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 de lectura / v6
Termostato de lectura / escritura / v6
Escribir:
Termostato de lectura / escritura / v5-v6

luz_corriente_activado

Estado habilitado con bloqueador solar. 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, lee y configura la temperatura correcta.

Para obtener más información, consulte ¿Qué es Sunblock?

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

luz solar_corrección_activa

Estado activo de bloqueador solar. Usado con sunlight_correction_enabled . Cuando es true , indica que el termostato está ubicado bajo la luz solar directa.

Para obtener más información, consulte ¿Qué es Sunblock?

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

donde_nombre

El nombre para mostrar del dispositivo. Asociado 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 dónde están los nombres de los termostatos Nest , 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 de lectura / v6
Termostato de lectura / escritura / v6

fan_timer_duration

Especifica el período de tiempo (en minutos) que el ventilador está configurado para funcionar.

La configuración fan_timer_active enciende el ventilador. El valor 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 de lectura / v6
Termostato de lectura / escritura / v6
Escribir:
Termostato de lectura / escritura / v6

time_to_target

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

Consulte Tiempo hasta 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 de lectura / v6
Termostato de 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 necesario para alcanzar la temperatura objetivo, este valor cambiará de training a ready .

Consulte Tiempo hasta 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: "entrenamiento", "listo"
Acceso solo lectura
Disponible en Termostato de lectura / v6
Termostato de lectura / escritura / v6

previous_hvac_mode

Muestra el último hvac_mode seleccionado. Se usa al cambiar 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 de lectura / v6
Termostato de lectura / escritura / v6