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
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Referencia de la API de Nest

La API de Nest modela una casa física o un edificio como una 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 horas punta activas).

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

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

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 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 funciona con limitaciones del mundo real. Por ejemplo, el termostato no debe hacer funcionar el aire acondicionado cuando la calefacción de emergencia está habilitada. Nuestra API está diseñada para salvaguardar tanto nuestros dispositivos como el hogar del usuario, y evitará determinadas acciones si resultan 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 permisos .

Datos y privacidad

Los datos relacionados con los productos para el hogar pueden ser muy personales. Los datos de los sensores domésticos contienen información sobre cómo las personas viven sus vidas en su espacio personal. La seguridad y el manejo de esos datos son muy importantes y un enfoque importante en Nest. Dejamos muy claro a los usuarios qué tipo de datos tenemos, cómo se utilizan 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/

access_token

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 ..."

client_version

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 de cliente antes de poder utilizar su 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 difiere para cada combinación de usuario y producto Works with Nest.

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

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