Notice: We're retiring Works with Nest. See the home page for more information.
Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

La arquitectura de la API de Nest

Acerca del servicio Nest

Las aplicaciones de Nest permiten a los usuarios conectarse con su hogar desde cualquier lugar. Todos los dispositivos Nest (termostatos, protectores y cámaras) y 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 de 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 en su medida actual y envía los datos del sensor al Asistente En casa / 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

La API de Nest 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 y reaccionar ante los dispositivos Nest y los cambios de estado relacionados.

Las structures nidos 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. Normalmente, una structure es la casa de un usuario.

Los devices Nest representan devices físicos (termostatos, protectores 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"). Los productos Works with Nest pueden leer y escribir 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 establece la estructura en Ausente.

Los objetos también funcionan bajo restricciones del mundo real. El modelo de datos protege los dispositivos y el hogar del usuario evitando acciones sorprendentes y peligrosas. Por ejemplo, el termostato no enciende el aire acondicionado cuando la calefacción de emergencia está habilitada.

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

Estado previsto

El servicio Nest almacena el estado autorizado del sistema y los productos 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 no ser 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.

Usando el servicio Nest

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

Permisos y autorización

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

La autorización se gestiona mediante el protocolo OAuth 2.0. Cuando un usuario acepta proporcionar acceso al nivel de permiso solicitado, Nest autentica la solicitud y se otorga un token de acceso al solicitante. Ese token de acceso se puede utilizar 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 .