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

идентификатор_структуры

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

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

имя_длинное

Длинное отображаемое имя устройства. Включает пользовательскую (метку), созданную пользователем или через 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.

См. Что такое аварийное тепло? для получения дополнительной информации о том, как термостат 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 для включения вентилятора на предустановленное (заданное пользователем) время.

Дополнительные сведения о том, как клиенты устанавливают продолжительность вентилятора, см. в разделе «Расширенное управление вентилятором».

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

целевая_температура_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

целевая_температура_с

Желаемая температура в полградуса Цельсия (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

целевая_температура_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

целевая_температура_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

целевая_температура_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

целевая_температура_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

эко_температура_высокая_f

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

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

эко_температура_высокая_с

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

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

эко_температура_low_f

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

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

эко_температура_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_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, такие как Нагрев•Охлаждение для систем с обогревом и охлаждением или Eco Temperatures для экономии энергии.

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

окружающая_температура_f

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

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

окружающая_температура_с

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

где_ид

Уникальный идентификатор, сгенерированный Nest, который представляет 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

солнечный свет_correction_enabled

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

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

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

солнечный свет_correction_active

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

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

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

где_имя

Отображаемое имя устройства. Связан с термостатом 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 установлено значение end.

Чтобы узнать, как клиенты устанавливают таймер вентилятора, см. раздел « Длительность таймера ».

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

время_до_цели

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

Дополнительную информацию см. в разделе «Время достижения температуры» .

Подробности
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 изучает систему HVAC и определяет, сколько времени требуется для достижения заданной температуры. Когда у термостата будет достаточно информации, чтобы сделать разумную оценку времени достижения целевой температуры, это значение изменится с training на состояние ready .

Дополнительную информацию см. в разделе «Время достижения температуры» .

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

предыдущий_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