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

Справочник по Nest API

API Nest моделирует физический дом или здание как структуру, а в качестве устройств в структуре используются учебные термостаты Nest, Nest Protects и Nest Cams. Эта структура также содержит информацию о доме в целом (например, в гостях или в состоянии ETA или в активные часы пик).

Каждый элемент данных в структуре адресуется с помощью URL ресурса (называемого «местоположениями данных») в общем документе JSON. Каждое местоположение данных может хранить строки, числа, логические значения, родительские / дочерние объекты или массивы.

Изучите модель данных с помощью этого интерактивного справочника API .

С помощью API вы можете синхронизировать данные из местоположений на нескольких уровнях в модели данных, например:

  • целая структура, включая все устройства
  • одно устройство в структуре
  • группа значений данных (текущая и температура окружающей среды)
  • одно значение данных (состояние батареи)

Ваши продукты должны вдумчиво реагировать на такие события:

Однако имейте в виду, что каждый объект на основе устройства работает в реальных условиях. Например, термостат не должен запускать кондиционер, когда включен аварийный обогрев. Наш API предназначен для защиты как наших устройств, так и дома пользователя, и будет предотвращать определенные действия, если они будут неожиданными или опасными.

Разрешения и общие данные устройства

Возможность чтения или записи в местоположение данных контролируется разрешениями. Группы разрешений предоставляют доступ на чтение, запись или чтение / запись к выбранным значениям данных в устройствах и структурах.

Для получения дополнительной информации см. Обзор разрешений .

Данные и конфиденциальность

Данные, связанные с домашними продуктами, могут быть очень личными. Данные домашнего датчика содержат информацию о том, как люди живут в своем личном пространстве. Безопасность и обработка этих данных очень важны, и особое внимание уделяется Nest. Мы четко разъясняем пользователям, какие у нас есть данные, как они используются и где они могут их контролировать.

Узнайте больше о наших взглядах на конфиденциальность .

Метаданные

Метаданные - это дополнительная информация, которая предоставляется при вызове конечной точки корневого уровня:

https://developer-api.nest.com/

access_token

После авторизации пользователя ваш продукт использует токен доступа для вызовов API службы Nest. Этот токен доступа служит доказательством того, что пользователь разрешил вашему продукту совершать звонки от его имени.

подробности
Возвращает string
Пример: "c.FmDPkzyzaQe ..."

client_version

Клиентская версия является последней авторизованной пользователем версией клиента и связана с access_token .

Когда вы обновляете разрешения для клиента, его версия увеличивается, и пользователь получает уведомление о наличии обновления. Ваши пользователи должны принять это обновление клиента, прежде чем они смогут использовать ваш обновленный продукт.

подробности
Возвращает number
Примеры: 1, 17, 42

Логин пользователя

Идентификатор пользователя позволяет идентифицировать пользователей через вызовы API. Этот идентификатор отличается для каждого продукта и пользовательской комбинации Works с Nest.

Например, если пользователь 1 авторизовал Works с продуктом Nest A и Works с продуктом user_id B, то продукт A имеет одно значение user_id для пользователя 1, а продукт B имеет другое значение user_id для пользователя 1.

подробности
Возвращает string
Пример: z.1.1.7DHps ...