Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Esta página se ha traducido con Cloud Translation API.
Switch to English

API termostato

La API Nido funciona con todos los modelos Nest Learning Thermostat ™, excepto por el termostato E con Enlace de calor en la UE.

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

Todo el debajo de los valores se encuentran bajo cada uno de devices/thermostats/ device_id en el documento JSON.

ID del dispositivo

Termostato Nest identificador único.

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 idioma y la región (o país) preferencia.

detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Devoluciones string
Ejemplos: "en-GB", "en-US", "es-nos", "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

structure_id

Estructurar identificador único.

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

Visualización del nombre del dispositivo. Puede ser cualquier nombre de la 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

NAME_LONG

nombre para mostrar largo del dispositivo. Incluye una costumbre (etiqueta), creado por el usuario, o por medio de wheres .

detalles
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Devoluciones string
Ejemplo: "Pasillo termostato (arriba)"
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6

last_connection

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

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

el estado de conexión del dispositivo con el servicio de 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

la 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 de lectura / V1-V6
Termostato de lectura / escritura / V1-V6

can_heat

la capacidad del sistema para el calor.

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 calefacción de emergencia en los sistemas con bombas de calor para la refrigeración.

Cuando la calefacción de emergencia está en:

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

Ver de qué 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 de lectura / V1-V6
Termostato de lectura / escritura / V1-V6

has_fan

la capacidad del sistema para controlar el ventilador independientemente de calefacción o 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 de lectura / V1-V6
Termostato de lectura / escritura / V1-V6

fan_timer_active

Indica si se activa el temporizador del ventilador; se utiliza con fan_timer_duration para encender el ventilador para una duración predeterminada (especificada por el usuario).

Ver Fan Control Avanzado para 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 llega a 0 (tiempo de parada), en la norma ISO 8601 de formato.

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

Se muestra cuando el termostato está ajustado 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 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 utiliza 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 grados Celsius y medio (0,5 ° C). Se utiliza 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 diana máxima, que se muestra en grados enteros Fahrenheit (1 ° F). Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

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

La temperatura máxima de destino, que se muestra en grados Celsius media (0,5 ° C). Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

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, que se muestra en grados enteros Fahrenheit (1 ° F). Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

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

La temperatura mínima de destino, que se muestra en grados Celsius media (0,5 ° C). Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

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 Máxima Eco, que se muestra en grados enteros Fahrenheit (1 ° F). Se utiliza 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 Máxima Eco, que se muestra en grados Celsius media (0,5 ° C). Se utiliza 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 mínima de Eco, que se muestra en grados enteros Fahrenheit (1 ° F). Se utiliza 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 mínima de Eco, que se muestra en grados Celsius media (0,5 ° C). Se utiliza 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 de distancia máxima, 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)

La temperatura máxima de distancia, que se muestra en grados Celsius media (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 de distancia mínima, que se muestra 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 de distancia mínima, que se muestra en la mitad de grados 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 enfriamiento HVAC calefacción sistema, como el calor • frío para sistemas de calefacción y capacidad de refrigeración o temperaturas Eco para el ahorro de energía.

detalles
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Devoluciones string enum
Valores: "calor", "fresco", "calor-frío", "eco", "off"
Acceso leer escribir
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6

ambient_temperature_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

ambient_temperature_c

Temperatura, medida en el dispositivo, en grados Celsius y medio (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

La humedad, en formato de porcentaje (%), medido en el dispositivo, redondeado 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 de HVAC está calentando activamente, de refrigeración o está apagado. Utilice este valor para indicar el estado de actividad de climatización.

Cuando off , el sistema de HVAC no se está calentando o enfriando 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: "calentar", "refrigeración", "off"
Acceso solo lectura
Disponible en Termostato de lectura / V3-V6
Termostato de lectura / escritura / V3-V6

where_id

Un identificador único, generado Nest-que representa name , el nombre de visualización del dispositivo.

Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

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

el estado de bloqueo del termostato. Cuando cierto, el termostato Lock función está activada, y restringe el intervalo de temperatura a estos valores mín / máx: 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

Mínimo termostato Lock temperatura, que se muestra en grados enteros Fahrenheit (1 ° F). Se utiliza 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

Máxima termostato Lock temperatura, que se muestra en grados enteros Fahrenheit (1 ° F). Se utiliza 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

Mínimo termostato Lock temperatura, representada en que se muestra en la mitad de grados Celsius (0,5 ° C). Se utiliza 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

Máxima termostato Lock temperatura, representada en que se muestra en la mitad de grados Celsius (0,5 ° C). Se utiliza 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

Termostato de etiqueta personalizada . Aparece entre paréntesis, después del nombre del lugar.

detalles
https://developer-api.nest.com/devices/thermostats/ device_id /label
Devoluciones string
Ejemplos: "Arriba", "Habitación", "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

sunlight_correction_enabled

Protector solar habilitado estado. Se utiliza con sunlight_correction_active . Cuando true , la tecnología Bloqueador solar está habilitado, y el termostato está regulando automáticamente a la luz solar directa, la lectura y ajuste de 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 de lectura / v6
Termostato de lectura / escritura / v6

sunlight_correction_active

SUNBLOCK estado activo. Se utiliza con sunlight_correction_enabled . Cuando true , indica que el termostato se encuentra en 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 de lectura / v6
Termostato de lectura / escritura / v6

where_name

El nombre de visualización del dispositivo. Asociado con el termostato where_id . Puede ser cualquier nombre de la sala de una lista que proporcionamos, o un nombre personalizado. Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

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 la longitud de tiempo (en minutos) que el ventilador está configurado para ejecutarse.

El fan_timer_active ajuste se enciende el ventilador. El fan_timer_timeout valor indica la marca de tiempo cuando fan_timer_duration se establece a extremo.

Para aprender cómo los clientes ajustar el temporizador del ventilador, ver la 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 tomará para que la estructura para alcanzar la temperatura deseada.

Ver Time-to-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 el modo de entrenamiento, los aprende termostato Nest sobre el sistema de climatización y descubre la cantidad de tiempo que tarda en alcanzar la temperatura deseada. Cuando el termostato tiene suficiente información para hacer una estimación razonable del tiempo para alcanzar la temperatura deseada, este valor cambiará de training a ready .

Ver Time-to-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 de lectura / v6
Termostato de lectura / escritura / v6

previous_hvac_mode

Muestra seleccionado el último hvac_mode . Se utiliza cuando se cambia de hvac_mode = eco en un dispositivo con firmware anticuado.

Para obtener más información acerca de cambiar Transcurrirá modos no-Eco Eco y, consulte la Guía del termostato .

detalles
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Devoluciones string
Valores: "calor", "fresco", "calor-frío", "OFF", espacio en blanco (sin valor)
Acceso solo lectura
Disponible en Termostato de lectura / v6
Termostato de lectura / escritura / v6