Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Эта страница переведена с помощью Cloud Translation API.
Switch to English

Структура API

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

Все указанные ниже значения находятся под каждой structures/ structure_id в документе JSON.

structure_id

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

Подробности
https://developer-api.nest.com/structures/ structure_id /structure_id
Возврат string
Пример: «VqFabWH21nw ...»
Доступ только чтение
Доступно в Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Дым + чтение CO / v1-v5
В гостях читать / v1-v2
Отсутствует чтение / запись / v1-v2
ETA write / v1-v2
Почтовый индекс читать / v2
Чтение камеры / v1-v3
Чтение камеры + изображения / v1-v4
Чтение / запись камеры / v1-v3
Чтение / запись камеры + изображения / v1-v4
Считывание энергии / v2

термостаты

Список термостатов в структуре по уникальному идентификатору устройства. Это массив объектов JSON, который включает в себя все термостаты в структуре.

Подробности
https://developer-api.nest.com/structures/ structure_id /thermostats
Возврат array
Пример: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Доступ только чтение
Доступно в Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Дым + чтение CO / v1-v5
В гостях читать / v1-v2
Отсутствует чтение / запись / v1-v2
ETA write / v1-v2
Чтение камеры / v2-v3
Чтение камеры + изображения / v2-v4
Чтение / запись камеры / v2-v3
Чтение / запись камеры + изображения / v2-v4

smoke_co_alarms

Список извещателей дыма + CO в конструкции по уникальному идентификатору устройства. Это массив объектов JSON, который включает в себя все сигнализаторы дыма + CO в структуре.

Подробности
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
Возврат array
Пример: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Доступ только чтение
Доступно в Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Дым + чтение CO / v1-v5
В гостях читать / v1-v2
Отсутствует чтение / запись / v1-v2
ETA write / v1-v2
Чтение камеры / v2-v3
Чтение камеры + изображения / v2-v4
Чтение / запись камеры / v2-v3
Чтение / запись камеры + изображения / v2-v4

камеры

Список камер в структуре по уникальному идентификатору устройства. Это массив объектов JSON, включающий все камеры в структуре.

Подробности
https://developer-api.nest.com/structures/ structure_id /cameras
Возврат array
Пример: [ "awJo6rH...",... ]
Доступ только чтение
Доступно в Чтение термостата / v4-v6
Термостат чтения / записи / v4-v6
Дым + чтение CO / v4-v5
В гостях читать / v2
Нет на месте чтение / запись / v2
ETA write / v2
Чтение камеры / v1-v3
Чтение камеры + изображения / v1-v4
Чтение / запись камеры / v1-v3
Чтение / запись камеры + изображения / v1-v4

далеко

Указывает на заполненность конструкции.

У структур есть два состояния, связанных с присутствием: home или away . Когда движение не ощущается в доме, структура будет меняться от home к away .

Подробности
https://developer-api.nest.com/structures/ structure_id /away
Возврат string
Значения: «дома», «в гостях».
Доступ читай пиши
Доступно в Читать:
Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Дым + чтение CO / v1-v5
В гостях читать / v1-v2
Отсутствует чтение / запись / v1-v2
ETA write / v1-v2
Писать:
Отсутствует чтение / запись / v1-v2

название

Пользовательское отображаемое имя структуры.

Подробности
https://developer-api.nest.com/structures/ structure_id /name
Возврат string
Примеры: «Мой дом», «Дом на пляже», «Дом в горах».
Доступ читай пиши
Доступно в Читать:
Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Дым + чтение CO / v1-v5
В гостях читать / v1-v2
Отсутствует чтение / запись / v1-v2
ETA write / v1-v2
Почтовый индекс читать / v2
Чтение камеры / v1-v3
Чтение камеры + изображения / v1-v4
Чтение / запись камеры / v1-v3
Чтение / запись камеры + изображения / v1-v4
Считывание энергии / v2
Структура чтения / записи / v1
Писать:
Структура чтения / записи / v1

код страны

Код страны в формате ISO 3166 alpha-2 .

Подробности
https://developer-api.nest.com/structures/ structure_id /country_code
Возврат string
Примеры: «США», «Калифорния», «Великобритания».
Доступ только чтение
Доступно в Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Дым + чтение CO / v1-v5
В гостях читать / v1-v2
Нет на месте чтение / запись / v1-v2
ETA write / v1-v2

Почтовый индекс

Почтовый или почтовый индекс, в зависимости от страны.

Подробности
https://developer-api.nest.com/structures/ structure_id /postal_code
Возврат string
Примеры: «94304», «94304-1027», «EC1A 1BB».
Доступ только чтение
Доступно в Почтовый индекс читать / v1-v2

peak_period_start_time

Время начала события « Час пик энергии» в формате ISO 8601 .

Подробности
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
Возврат string
Пример: «2016-12-31T23: 59: 59.000Z».
Доступ только чтение
Доступно в Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Считывание энергии / v1-v2

peak_period_end_time

Время окончания события « час пик» в формате ISO 8601 .

Подробности
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
Возврат string
Пример: «2016-12-31T23: 59: 59.000Z».
Доступ только чтение
Доступно в Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Считывание энергии / v1-v2

часовой пояс

Часовой пояс в структуре в формате часового пояса IANA .

Подробности
https://developer-api.nest.com/structures/ structure_id /time_zone
Возврат string
Пример: «Америка / Лос-Анджелес».
Доступ только чтение
Доступно в Чтение термостата / v1-v6
Термостат чтения / записи / v1-v6
Дым + чтение CO / v1-v5
В гостях читать / v1-v2
Нет на месте чтение / запись / v2
ETA write / v1-v2

эта

ETA (предполагаемое время прибытия) - это объект, который может быть установлен на конструкции. Он используется, чтобы сообщить Nest, что пользователь должен вернуться домой в определенное время. Для получения информации о том, как сделать звонок ETA, см. « Путеводитель на выезде» .

Подробности
https://developer-api.nest.com/structures/ structure_id /eta
Возврат object
Пример: «myTripID1024», «2014-10-31T22: 42: 00.000Z», «2016-12-31T23: 59: 59.000Z».
Параметры
trip_id Строка, определяемая пользователем, определяющая поездку.
estimated_arrival_window_begin Отметка времени в формате ISO 8601 .
Должно быть больше, чем NOW .
estimated_arrival_window_end Отметка времени в формате ISO 8601 .
Должно быть больше estimated_arrival_window_begin .
Доступ только для записи
Доступно в ETA write / v1-v2

eta_begin

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

Подробности
https://developer-api.nest.com/structures/ structure_id /eta_begin
Возврат string
Пример: «2016-12-31T23: 59: 59.000Z».
Доступ только чтение
Доступно в ETA читать / v1

rhr_enrollment

Статус регистрации в программе Rush Hour Rewards .

Подробности
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
Возврат boolean
Значения: истина, ложь
Доступ только чтение
Доступно в Считывание энергии / v1-v2

wwn_security_state

Состояние безопасности структуры.

Подробности
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
Тип string enum
Значения: «хорошо», «сдерживать».
Доступ только чтение
Доступно в Состояние безопасности прочитано / v1

где

Объект, содержащий идентификаторы where_id ( where_id и name ) для устройств в структуре. name - отображаемое имя устройства. Это может быть любое имя комнаты из предоставленного нами списка или произвольное имя.

Для получения дополнительной информации о wheres , см. Руководство по структуре .

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

Подробности
https://developer-api.nest.com/structures/ structure_id /wheres
Возврат object
Доступ только чтение
Доступно в Читать:
Чтение термостата / v3-v6
Термостат чтения / записи / v3-v6
Дым + чтение CO / v3-v5
Чтение камеры / v1-v3
Чтение камеры + изображения / v1-v4
Чтение / запись камеры / v1-v3
Чтение / запись камеры + изображения / v1-v4

where_id

Уникальный идентификатор, созданный Nest, который представляет name .

where_id автоматически создается и возвращается во время вызова для создания name .

Подробности
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
Возврат string
Пример: «Fqp6wJI ...»
Доступ только чтение
Доступно в Читать:
Чтение термостата / v3-v6
Термостат чтения / записи / v3-v6
Дым + чтение CO / v3-v5
Чтение камеры / v1-v3
Чтение камеры + изображения / v1-v4
Чтение / запись камеры / v1-v3
Чтение / запись камеры + изображения / v1-v4

название

Отображаемое имя устройства.

Подробности
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
Возврат string
Пример: «Спальня»
Доступ читай пиши
Доступно в Читать:
Чтение термостата / v3-v6
Термостат чтения / записи / v3-v6
Дым + чтение CO / v3-v5
Чтение камеры / v1-v3
Чтение камеры + изображения / v1-v4
Чтение / запись камеры / v1-v3
Чтение / запись камеры + изображения / v1-v4

co_alarm_state

Состояние тревоги CO.

Подробности
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
Возврат string enum
Значения: «ок», «предупреждение», «аварийная ситуация».
Доступ только чтение
Доступно в Дым + чтение CO / v5

Smoke_alarm_state

Состояние дымовой сигнализации.

Подробности
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
Возврат string enum
Значения: «ок», «предупреждение», «аварийная ситуация».
Доступ только чтение
Доступно в Дым + чтение CO / v5