Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

La arquitectura de la API de Nest

Sobre el servicio Nest

Las aplicaciones Nest permiten a los usuarios conectarse con su hogar desde donde se encuentren. Todos los dispositivos Nest (termostatos, protecciones y cámaras) y las aplicaciones (iOS, Android y aplicaciones web) se conectan al servicio Nest.

Ejemplo de nube a nube

El servicio Nest proporciona un modelo de datos del hogar. Los dispositivos y las aplicaciones leen este modelo de datos para tomar las medidas adecuadas. Actualizan el modelo de datos para reflejar los cambios en el sistema.

Por ejemplo, un termostato lee su temperatura objetivo del modelo de datos. Establece la temperatura ambiente a su medición actual y envía datos del sensor a la Asistencia local / ausente, que ajusta el modo de estructura en consecuencia.

Los dispositivos Nest funcionan en entornos restringidos. La energía es limitada y la conectividad de la red doméstica puede ser poco confiable. Sus productos y servicios pueden aprovechar los algoritmos de nuestros dispositivos para ofrecer a los usuarios una experiencia hogareña simple e intuitiva.

El modelo de datos

Nest API se representa como un documento JSON con atributos de nivel superior de metadata , devices y structures . Sus productos Works with Nest utilizan este documento JSON para interactuar con los dispositivos Nest y los cambios de estado relacionados y reaccionar ante ellos.

Las structures nido representan structures físicas en el mundo real. Sirven como un punto de organización para devices y almacenan datos para el edificio en su conjunto. Típicamente, una structure es un hogar de usuario.

Los devices Nest representan devices físicos (termostatos, protecciones y cámaras) dentro de una estructura.

Cada elemento de datos en el documento JSON es direccionable por URL (también conocido como "ubicaciones de datos"). Works con productos Nest puede leer y escribir en secciones de este documento y suscribirse a los cambios. Esta capacidad de suscripción permite que los productos Works with Nest reaccionen en tiempo real a los cambios realizados en el sistema, como apagar las luces cuando un usuario configura la estructura como Ausente.

Los objetos también funcionan bajo restricciones del mundo real. El modelo de datos protege los dispositivos y el hogar del usuario al evitar acciones sorprendentes y peligrosas. Por ejemplo, el termostato no hace funcionar el aire acondicionado cuando el calor de emergencia está activado.

Explore el modelo de datos con esta referencia interactiva de API .

Estado previsto

El servicio Nest almacena el estado autorizado del sistema y los productos de Works with Nest se suscriben a los cambios. La modificación de este estado (por ejemplo, para cambiar la temperatura objetivo de un termostato) hace que el servicio envíe una notificación de cambio a todos los suscriptores.

Debido a que esta propagación tiene cierto retraso y las redes pueden ser poco confiables, el estado observado por un producto puede no ser el estado observado actualmente por otros productos o el servicio. El estado finalmente se sincroniza a medida que se transmiten mensajes entre varios productos.

Este modelo de publicación / suscripción orientado a documentos proporciona interacciones de aplicación receptivas.

Usar el servicio Nest

Para acceder a los puntos finales REST en el servicio Nest, use HTTPS en su producto. Hay muchas bibliotecas de clientes de terceros que se pueden usar para este propósito.

Permisos y autorizaciones

Queremos permitir que los desarrolladores creen productos y servicios que mejoren los hogares, sin comprometer la seguridad y la privacidad del usuario. Todas nuestras comunicaciones son seguras, y el usuario siempre otorga explícitamente permiso para acceder a los datos. Para obtener más información, consulte la Descripción general de los permisos .

La autorización se maneja mediante el protocolo OAuth 2.0. Cuando un usuario acepta proporcionar acceso al nivel de permiso solicitado, Nest autentica la solicitud y se le otorga un token de acceso al solicitante. Ese token de acceso se puede usar para acceder a la API de Nest e interactuar con las estructuras y dispositivos del usuario.

La concesión de un token de acceso establece una relación de confianza entre un usuario, un producto Works with Nest y Nest. Los usuarios pueden revocar el acceso en cualquier momento.

Para saber cómo autorizar una conexión a la API de Nest, consulte la Descripción general de la autorización .