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 для экономии энергии.
-
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 |
окружающая_температура_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 |