Google стремится продвигать расовую справедливость для черных сообществ. Смотри как.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Архитектура Nest API

О службе Гнездо

Приложения Nest позволяют пользователям подключаться к своему дому, где бы они ни находились. Все устройства Nest (термостаты, защитные устройства и камеры) и приложения (iOS, Android и веб-приложения) подключаются к службе Nest.

Пример облако в облако

Сервис Nest предоставляет модель данных дома. Устройства и приложения считывают эту модель данных, чтобы предпринять соответствующие действия. Они обновляют модель данных для отражения изменений в системе.

Например, термостат считывает свою целевую температуру из модели данных. Он устанавливает текущую температуру окружающей среды и отправляет данные датчика в Home / Away Assist, который соответствующим образом настраивает режим конструкции.

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

Модель данных

API Nest представлен в виде документа JSON с атрибутами верхнего уровня metadata , devices и structures . В ваших продуктах Works with Nest этот документ JSON используется для взаимодействия и реагирования на устройства Nest и связанные с ними изменения состояния.

Гнездовые structures представляют физические структуры в реальном мире. Они служат для организации devices и хранения данных для здания в целом. Как правило, structure - это дом пользователя.

devices Nest представляют собой физические устройства (термостаты, защитные устройства и камеры) внутри структуры.

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

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

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

Предполагаемое состояние

Сервис Nest сохраняет официальное состояние системы, а продукты Works с Nest подписываются на изменения. Изменение этого состояния (например, для изменения целевой температуры термостата) заставляет службу выдавать уведомления об изменениях всем подписчикам.

Поскольку это распространение имеет некоторую задержку и сети могут быть ненадежными, состояние, наблюдаемое продуктом, может не быть состоянием, наблюдаемым в настоящее время другими продуктами или услугой. Состояние в конечном итоге синхронизируется, поскольку сообщения передаются между различными продуктами.

Эта ориентированная на документы модель публикации / подписки обеспечивает адаптивные взаимодействия приложений.

Использование сервиса Nest

Чтобы получить доступ к конечным точкам REST в службе Nest, используйте HTTPS в своем продукте. Существует много сторонних клиентских библиотек, которые можно использовать для этой цели.

Разрешения и авторизация

Мы хотим, чтобы разработчики могли создавать продукты и услуги, которые улучшают обстановку дома без ущерба для конфиденциальности и безопасности пользователей. Все наши коммуникации безопасны, и разрешение на доступ к данным всегда явно предоставляется пользователем. Для получения дополнительной информации см. Обзор разрешений .

Авторизация обрабатывается протоколом OAuth 2.0. Когда пользователь соглашается предоставить доступ к запрошенному уровню разрешений, Nest аутентифицирует запрос и токен доступа предоставляется запрашивающему. Этот токен доступа можно использовать для доступа к Nest API и взаимодействия со структурами и устройствами пользователя.

Предоставление токена доступа устанавливает доверительные отношения между пользователем, продуктом Works with Nest и Nest. Пользователи могут отозвать доступ в любое время.

Чтобы узнать, как авторизовать соединение с Nest API, см. Обзор авторизации .