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

Referencia API de Nest

Nest API modela una casa o edificio físico como estructura, con Nest Learning Thermostats, Nest Protects y Nest Cams como dispositivos en la estructura. Esta estructura también contiene información sobre el hogar en su conjunto (como el estado Ausente o ETA, o las horas de actividad).

Cada elemento de datos en la estructura es direccionable por una URL de recurso (llamada "ubicaciones de datos") en un documento JSON compartido. Cada ubicación de datos puede almacenar cadenas, números, booleanos, objetos primarios / secundarios o matrices.

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

Desde la API, puede sincronizar datos de ubicaciones en varios niveles en el modelo de datos, por ejemplo:

  • una estructura completa, incluidos todos los dispositivos
  • un solo dispositivo en una estructura
  • Un grupo de valores de datos (temperatura actual y ambiente)
  • un solo valor de datos (estado 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 funciona bajo restricciones del mundo real. Por ejemplo, el termostato no debe hacer funcionar el aire acondicionado cuando el calor de emergencia está activado. Nuestra API está diseñada para proteger nuestros dispositivos y el hogar del usuario, y evitará ciertas acciones si fueran sorprendentes o peligrosas.

Permisos y datos compartidos del dispositivo

La capacidad de leer o escribir en una ubicación de datos está controlada por permisos. Los grupos de permisos proporcionan acceso de lectura, escritura o lectura / escritura a valores de datos seleccionados en dispositivos y estructuras.

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

Datos y privacidad

Los datos relacionados con los productos para el hogar pueden ser muy personales. Los datos del sensor de inicio contienen información sobre cómo las personas viven sus vidas en su espacio personal. La seguridad y el manejo de esos datos es muy importante y un enfoque importante en Nest. Dejamos en claro a los usuarios qué tipo de datos tenemos, cómo se usan y dónde pueden controlarlos.

Obtenga más información sobre nuestras opiniones sobre la privacidad .

Metadatos

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

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

token de acceso

Después de la autorización del usuario, su producto utiliza un token de acceso para realizar llamadas API al servicio Nest. Este token de acceso sirve como prueba de que un usuario ha autorizado su producto para realizar llamadas en su nombre.

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

versión_cliente

La versión del cliente es la última versión autorizada por el usuario de un cliente, y está asociada con un access_token .

Cuando actualiza los permisos para un cliente, la versión del cliente se incrementa y se notifica al usuario que hay una actualización disponible. Sus usuarios deben aceptar esta actualización del cliente antes de poder usar su producto actualizado.

Detalles
Devoluciones number
Ejemplos: 1, 17, 42

ID_usuario

La ID de usuario le permite identificar usuarios a través de llamadas API. Este identificador difiere para cada combinación de producto y usuario de Works with Nest.

Por ejemplo, si el usuario 1 ha autorizado el producto A de Works with Nest y el producto B de Works with Nest, entonces el producto A tiene un valor user_id para el usuario 1, y el producto B tiene un valor user_id diferente para el usuario 1.

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