API термостата

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

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

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

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

Гнездо Термостат уникальный идентификатор.

подробности
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

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

подробности
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

Смотрите Что такое Аварийное тепло? для получения дополнительной информации о том, как Термостат Гнезда поддерживает Аварийное тепло.

подробности
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 Fan 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

temperature_scale

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

подробности
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 • Cool).

подробности
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 • Cool).

подробности
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 • Cool).

подробности
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 • Cool).

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

eco_temperature_high_f

Максимальная экологическая температура, указывается в градусах Фаренгейта (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

Максимальная экологическая температура, отображаемая в половине градусов Цельсия (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

Минимальная экологическая температура, указывается в градусах Фаренгейта (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

Минимальная экологическая температура, отображаемая в половине градуса Цельсия (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_tempera_high_f (УСТАРЕЛО)

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

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

away_tempera_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_tempera_low_f (УСТАРЕЛО)

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

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

away_tempera_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_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_state не зависит от работы вентилятора.

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

where_id

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

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

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

is_locked

Состояние блокировки термостата. Если установлено значение true, функция блокировки термостата включена и ограничивает диапазон температур следующими минимальными / максимальными значениями: 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

locked_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

locked_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

locked_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

locked_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

метка

Термостат по индивидуальному заказу . Появляется в скобках после имени где.

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

sunlight_correction_enabled

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

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

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

sunlight_correction_active

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

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

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

where_name

Отображаемое имя устройства. where_id с термостатом where_id . Может быть любым именем комнаты из предоставленного нами списка или произвольным именем. Узнайте больше о названиях термостатов Nest , Nest Protects и 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 Thermostat узнает о системе отопления, вентиляции и кондиционирования воздуха и обнаруживает, сколько времени требуется для достижения заданной температуры. Когда термостат имеет достаточно информации, чтобы сделать разумную оценку времени достижения целевой температуры, это значение изменится с 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 на устройстве с устаревшей прошивкой.

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

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