Notice: We're retiring Works with Nest. See the home page for more information.
En Google, luchamos por la equidad racial de la comunidad negra. Más información
Esta página se ha traducido con Cloud Translation API.
Switch to English

Nido de Referencia de la API

Los modelos de API Nest un hogar físico o la construcción como una estructura, con termostatos Nest Learning, Nest Protect, y el nido cámaras como dispositivos en la estructura. Esta estructura también contiene información acerca de la casa como un todo (como Ausente o estado de ETA, o las horas punta activos).

Cada elemento de datos en la estructura es direccionable por un URL de recursos (llamados "ubicaciones de datos") en un documento JSON compartido. Cada localización de datos puede almacenar cadenas, números, booleanos, objetos padre / hijo, o matrices.

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

A partir de la API, puede sincronizar los datos de localizaciones en múltiples niveles en el modelo de datos, por ejemplo:

  • una estructura completa, incluyendo todos los dispositivos
  • un único dispositivo en una estructura de
  • un grupo de valores de datos (temperatura actual y ambiente)
  • un solo valor de datos (estado de salud de la batería)

Sus productos deben responder cuidadosamente a eventos como estos:

Sin embargo, tenga en cuenta que cada uno de los objetos basados ​​en dispositivos están trabajando bajo las limitaciones del mundo real. Por ejemplo, el termostato no debe correr el aire acondicionado cuando se activa la calefacción de emergencia. Nuestro API está diseñado para proteger tanto a nuestros dispositivos y el domicilio del usuario, y evitará que ciertas acciones si estarían sorprendente o peligroso.

Permisos y datos de dispositivos compartidos

La capacidad de leer o escribir en una ubicación de datos es controlada por los permisos. Los grupos de permisos proporcionan leer, escribir o leer / escribir los valores de datos seleccionados en los dispositivos y estructuras.

Para obtener más información, consulte la Descripción general de permisos .

Los datos y la privacidad

Los datos involucrados con productos caseros pueden ser muy personal. los datos del sensor de inicio contiene información acerca de cómo las personas viven sus vidas en su espacio personal. La seguridad y administración de los datos es muy importante, y un enfoque significativo en el Nido. Ahora es más claro para los usuarios qué tipo de datos que tenemos, cómo se utiliza, y donde podemos controlarlo.

Más información sobre nuestros puntos de vista sobre la privacidad .

metadatos

Los metadatos son información adicional que se proporciona cuando se hace una llamada al punto final de nivel raíz:

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

señal_acceso

Después de la autorización del usuario, el producto utiliza un token de acceso para realizar llamadas a la API para el servicio Nido. Este token de acceso sirve como prueba de que un usuario ha autorizado su producto a las llamadas toman por ellos.

detalles
Devoluciones string
Ejemplo: "c.FmDPkzyzaQe ..."

client_version

La versión del cliente es la última versión autorizado por el usuario de un cliente, y se asocia con un access_token .

Al actualizar los permisos para un cliente, la versión del cliente se incrementa, y el usuario es notificado de que hay una actualización disponible. Los usuarios deben aceptar esta actualización del cliente antes de que puedan utilizar el producto actualizado.

detalles
Devoluciones number
Ejemplos: 1, 17, 42

user_id

El ID de usuario le permite identificar a los usuarios a través de llamadas a la API. Este identificador es diferente para cada producto Funciona con nido y la combinación de usuario.

Por ejemplo, si el usuario 1 ha autorizado Works con la jerarquía producto A y trabaja con producto Nest B, a continuación, el producto A tiene un user_id valor para los usuarios 1, y el producto B tiene un diferente user_id valor para los usuarios 1.

detalles
Devoluciones string
Ejemplo: z.1.1.7DHps ...