API термостата

Nest API работает со всеми моделями Nest Learning Thermostat ™, за исключением Thermostat E с Heat Link в ЕС.

Пользователи могут добавлять несколько термостатов Nest в devices/thermostats группы, вплоть до максимума в структуре . Когда вы звоните в это хранилище данных, вы можете получить доступ к данным Nest Thermostat (значениям данных для устройств в структуре).

Все ниже значений находится под каждое devices/thermostats/ device_id в документе JSON.

идентификатор устройства

Уникальный идентификатор термостата Nest.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Возврат	string Пример: "peyiJNo0IldT2YlIVtYaGQ"
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

локаль

Задает предпочтительный язык и регион (или страну).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Возврат	string Примеры: en-GB, en-US, es-US, fr-CA, fr-CA, nl-NL.
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

Версия ПО

Версия ПО.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Возврат	string Пример: «4.0»
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

structure_id

Уникальный идентификатор структуры.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Возврат	string Пример: «VqFabWH21nw ...»
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

название

Отображаемое имя устройства. Может быть любое название комнаты из предоставленного нами списка или произвольное название.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /name
Возврат	string Пример: «Прихожая».
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

name_long

Длинное отображаемое имя устройства. Включает в себя пользовательские (ярлык), созданный пользователем, или через wheres .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Возврат	string Пример: «Термостат в коридоре (наверху)»
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

last_connection

Отметка последнего успешного взаимодействия со службой Nest, в ISO 8601 формате.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Возврат	string Пример: «2016-12-31T23: 59: 59.000Z».
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

В сети

Состояние подключения устройства к службе Nest.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

can_cool

Способность системы к охлаждению (есть AC).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

can_heat

Способность системы к нагреву.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

is_using_emergency_heat

Состояние аварийного нагрева в системах с тепловыми насосами для охлаждения.

Когда включен аварийный обогрев:

• Пользователь может настроить целевую температуру на устройстве, но не может изменить режим, пока аварийный нагрев не будет отключен.
• hvac_mode все еще может быть изменено с помощью API

См Что Emergency тепла? для получения дополнительной информации о том, как термостат Nest поддерживает аварийный нагрев.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

has_fan

Возможность системы управлять вентилятором независимо от нагрева или охлаждения.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

fan_timer_active

Указывает, включен ли таймер вентилятора; используется с fan_timer_duration для включения вентилятора для (заданного пользователя) заданной длительности.

См Advanced Control Вентилятор для получения дополнительной информации о том , как клиенты установить продолжительность вентилятора.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Возврат	boolean Значения: истина, ложь
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

fan_timer_timeout

Отметка показывает , когда таймер вентилятора достигает 0 (время остановки), в ISO 8601 формата.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Возврат	string Пример: «2016-12-31T23: 59: 59.000Z».
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

has_leaf

Отображается, когда термостат настроен на энергосберегающую температуру.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

температурная шкала

По Фаренгейту или Цельсию; используется с дисплеем температуры.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Возврат	string enum Значения: «F», «C»
Доступ	читай пиши
Доступно в	Читать: Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6 Писать: Термостат чтения / записи / v5-v6

target_temperature_f

Желаемая температура в градусах Фаренгейта (1 ° F). Используется при hvac_mode = heat или cool .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Возврат	number Пример: 72
Диапазон	50-90
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

target_temperature_c

Желаемая температура в полградуса Цельсия (0,5 ° C). Используется при hvac_mode = heat или cool .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Возврат	number Пример: 21,5
Диапазон	9-32
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

target_temperature_high_f

Максимальная целевая температура, отображаемая в целых градусах Фаренгейта (1 ° F). При использовании hvac_mode = heat-cool (Heat • Холодный режим).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Возврат	number Пример: 80
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

target_temperature_high_c

Максимальная целевая температура, отображаемая в половинных градусах Цельсия (0,5 ° C). При использовании hvac_mode = heat-cool (Heat • Холодный режим).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Возврат	number Пример: 24,5
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

target_temperature_low_f

Минимальная целевая температура, отображаемая в целых градусах Фаренгейта (1 ° F). При использовании hvac_mode = heat-cool (Heat • Холодный режим).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Возврат	number Пример: 65
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

target_temperature_low_c

Минимальная целевая температура, отображаемая с точностью до половины градусов Цельсия (0,5 ° C). При использовании hvac_mode = heat-cool (Heat • Холодный режим).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Возврат	number Пример: 19,5
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

eco_temperature_high_f

Максимальная температура Eco, отображается в целых градусах Фаренгейта (1 ° F). Используется при hvac_mode = eco .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Возврат	number Пример: 80
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

eco_temperature_high_c

Максимальная температура Eco, отображается с точностью до половины градусов Цельсия (0,5 ° C) Используется при hvac_mode = eco .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Возврат	number Пример: 24,5
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

eco_temperature_low_f

Минимальная температура Eco, отображается в целых градусах Фаренгейта (1 ° F). Используется при hvac_mode = eco .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Возврат	number Пример: 65
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

eco_temperature_low_c

Минимальная температура Eco, отображается с точностью до половины градусов Цельсия (0,5 ° C). Используется при hvac_mode = eco .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Возврат	number Пример: 19,5
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

away_temperature_high_f (УСТАРЕЛО)

Максимальная удаленная температура, отображаемая в целых градусах Фаренгейта (1 ° F).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Возврат	number Пример: 80
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

away_temperature_high_c (УСТАРЕЛО)

Максимальная удаленная температура, отображаемая в половине градусов Цельсия (0,5 ° C)

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Возврат	number Пример: 24,5
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

away_temperature_low_f (УСТАРЕЛО)

Минимальная удаленная температура, отображаемая в целых градусах Фаренгейта (1 ° F).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Возврат	number Пример: 65
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

away_temperature_low_c (УСТАРЕЛО)

Минимальная температура на удалении, отображаемая с точностью до половины градусов Цельсия (0,5 ° C).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Возврат	number Пример: 19,5
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

hvac_mode

Указывает на режимы обогрева / охлаждения системы HVAC, например «Нагрев • Охлаждение» для систем с мощностью обогрева и охлаждения или «Эко-температура» для экономии энергии.

• hvac_mode может быть изменен , если термостат заблокирован
• target_temperature_f и target_temperature_c не может быть изменена , если hvac_mode = off или eco

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Возврат	string enum Значения: «тепло», «прохладно», «тепло-прохладно», «эко», «выключено».
Доступ	читай пиши
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

ambient_temperature_f

Температура, измеренная на устройстве, в целых градусах Фаренгейта (1 ° F).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Возврат	number Пример: 72
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

ambient_temperature_c

Температура, измеряемая на устройстве, в половине градусов Цельсия (0,5 ° C).

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Возврат	number Пример: 21,5
Доступ	только для чтения
Доступно в	Чтение термостата / v1-v6 Термостат чтения / записи / v1-v6

влажность

Влажность в формате процентов (%), измеренная на устройстве, с округлением до ближайших 5%.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Возврат	number Пример: 35
Диапазон	0–100
Доступ	только для чтения
Доступно в	Чтение термостата / v2-v6 Термостат чтения / записи / v2-v6

hvac_state

Указывает, работает ли система HVAC в режиме активного нагрева, охлаждения или выключена Используйте это значение, чтобы указать состояние активности HVAC.

Когда off , система HVAC не активно нагрева или охлаждения. hvac_state не зависит от работы вентилятора.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Возврат	string enum Значения: «нагрев», «охлаждение», «выключено».
Доступ	только для чтения
Доступно в	Чтение термостата / v3-v6 Термостат чтения / записи / v3-v6

where_id

Уникальный, гнездо сгенерированный идентификатор , который представляет собой name , отображаемое имя устройства.

Узнайте больше о том, где названия Nest термостатов ,гнездо защищает и гнездо Cams .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Возврат	string Пример: "d6reb_OZTM ..."
Доступ	только для чтения
Доступно в	Чтение термостата / v4-v6 Термостат чтения / записи / v4-v6

is_locked

Состояние блокировки термостата. Когда правда, термостат блокировки функция включена, и ограничивает диапазон температуры до этих мин / макс значений: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c и locked_temp_max_c .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v5-v6 Термостат чтения / записи / v5-v6

lock_temp_min_f

Минимальное Термостат блокировки температуры, отображается в целых градусах по Фаренгейту (1 ° F). Используется , когда is_locked это true .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Возврат	string Пример: 65
Доступ	только для чтения
Доступно в	Чтение термостата / v5-v6 Термостат чтения / записи / v5-v6

lock_temp_max_f

Максимальный термостат блокировка температура, отображается в целых градусах по Фаренгейту (1 ° F). Используется , когда is_locked это true .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Возврат	string Пример: 80
Доступ	только для чтения
Доступно в	Чтение термостата / v5-v6 Термостат чтения / записи / v5-v6

lock_temp_min_c

Минимальное Термостат блокировки температуры, отображается в отображаемом в половине градусов по Цельсию (0,5 ° C). Используется , когда is_locked это true .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Возврат	string Пример: 19,5
Доступ	только для чтения
Доступно в	Чтение термостата / v5-v6 Термостат чтения / записи / v5-v6

lock_temp_max_c

Максимальный термостат блокировки температуры, отображается в отображаемом в половине градусов по Цельсию (0,5 ° C). Используется , когда is_locked это true .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Возврат	string Пример: 24,5
Доступ	только для чтения
Доступно в	Чтение термостата / v5-v6 Термостат чтения / записи / v5-v6

метка

Термостат на заказ ярлык . Появляется в скобках после имени where.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /label
Возврат	string Примеры: «Наверх», «Комната для гостей», «Игровая комната».
Доступ	читай пиши
Доступно в	Читать: Чтение термостата / v6 Чтение / запись термостата / v6 Писать: Термостат чтения / записи / v5-v6

sun_correction_enabled

Статус включен солнцезащитный крем. Используется с sunlight_correction_active . Когда true , технология Sunblock включена, и термостат автоматически приспосабливается к воздействию прямых солнечных лучей, чтения и установки нужной температуры.

Для получения дополнительной информации см Что такое Sunblock?

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

солнечный свет_коррекция_активный

Активный статус солнцезащитного крема. Используется с sunlight_correction_enabled . Когда true , указывает на то, что термостат находится под прямыми солнечными лучами.

Для получения дополнительной информации см Что такое Sunblock?

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

где_имя

Отображаемое имя устройства. Связанный с термостатом where_id . Может быть любое название комнаты из предоставленного нами списка или произвольное название. Узнайте больше о том, где названия Nest термостатов ,гнездо защищает и гнездо Cams .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Возврат	string Пример: «Прихожая».
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

fan_timer_duration

Задает продолжительность работы вентилятора (в минутах).

fan_timer_active установка включает вентилятор. fan_timer_timeout значение указует на метку время , когда fan_timer_duration установлен в конец.

Чтобы узнать , как клиенты установить таймер вентилятора, см Таймер продолжительности .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Возврат	int Значения: 15, 30, 45, 60, 120, 240, 480, 720.
Доступ	читай пиши
Доступно в	Читать: Чтение термостата / v6 Чтение / запись термостата / v6 Писать: Чтение / запись термостата / v6

time_to_target

Время в минутах, которое потребуется конструкции, чтобы достичь заданной температуры.

См времени до температуры для получения дополнительной информации.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Возврат	string enum Значения: «~ 0», «<5», «~ 15», «~ 90», «120».
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

time_to_target_training

В режиме обучения термостат Nest изучает систему отопления, вентиляции и кондиционирования воздуха и определяет, сколько времени требуется для достижения заданной температуры. Когда термостат имеет достаточно информации , чтобы сделать разумную оценку времени , чтобы достичь заданной температуры, то это значение будет меняться от training к ready .

См времени до температуры для получения дополнительной информации.

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Возврат	string enum Ценности: «обучение», «готово».
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6

previous_hvac_mode

Отображение последнего выбранного hvac_mode . Используется при переходе от hvac_mode = eco на устройстве с устаревшей прошивкой.

Чтобы узнать больше о переходе betwen Эко и не-Eco режимов, смотрите Руководство термостата .

Подробности
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Возврат	string Значения: «тепло», «охлаждение», «тепло-охлаждение», «выключено», пусто (без значения).
Доступ	только для чтения
Доступно в	Чтение термостата / v6 Чтение / запись термостата / v6