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

Alarma de humo + CO

Alarma de humo + CO

Nest Protect está diseñado para detectar humo y monóxido de carbono (CO) en un entorno residencial, con múltiples sensores para ayudarlo a comprender lo que sucede en el hogar.

Nest API proporciona acceso a los siguientes datos en Nest Protect:

  • Estado de alarma de humo o monóxido de carbono (CO)
  • Estado de la batería
  • Último estado de prueba manual y marca de tiempo
  • Estado en línea e información de la última conexión
  • Nombre de la estructura y dispositivo "nombre del lugar" (ubicación en el hogar)

Permisos de humo + CO

Para obtener acceso de lectura a todos los valores de datos API de alarma Smoke + CO, seleccione el permiso de lectura Smoke + CO para su cliente.

No hay permisos de escritura disponibles para la API de alarma Smoke + CO.

Identificadores de humo + CO

Dispositivo

Los dispositivos Nest se enumeran por tipo como una matriz de ID, que se pueden utilizar para identificar de forma única un dispositivo a través de la ruta del dispositivo. Por lo tanto, una ID de alarma de humo + co de "RTMTKxs..." significa que puede cargar el modelo de dispositivo de alarma de humo + co en devices/smoke_co_alarms/RTMTKxs... través de la API.

Cuando un dispositivo está conectado a varios productos, cada desarrollador verá una ID diferente para ese dispositivo. Para un dispositivo que ha instalado varios productos del mismo desarrollador, el desarrollador verá la misma ID.

Nombre

Se proporcionan dos atributos de nombre. El atributo de name más corto se muestra en las etiquetas de la interfaz de usuario, mientras que name_long se usa en texto de formato largo.

name

En este ejemplo, el name es "Nest Protect".

Nombre

name_long

En este ejemplo, name_long es "Basement Nest Protect".

Nombre largo

Dónde

where_id

  • Un identificador único generado por Nest que representa el name
  • where_id es de solo lectura y se crea automáticamente en la llamada para crear un name personalizado donde

Obtén más información sobre dónde están los nombres de los termostatos Nest , Nest Protects y Nest Cams .

where_name

Cuando elige el permiso de lectura Smoke + CO , puede acceder al dispositivo where_name desde el objeto del dispositivo ( devices/smoke_co_alarms ).

Otros metadatos

Todos los valores de datos son de solo lectura, a menos que se especifique lo contrario.

Valor de los datos Descripción
locale El idioma y el código de país asignado a este dispositivo
software_version Una cadena que representa el firmware actualmente instalado en el dispositivo
structure_id Una cadena que representa de manera única esta estructura; esta es la estructura con la que se empareja el dispositivo
last_connection La marca de tiempo de la última conexión exitosa al servicio Nest
is_online Estado en línea. Nest determina esto utilizando el tiempo de last_connection y una ventana de reconexión esperada que es específica del dispositivo.

Características de humo + CO

Estado de la batería

Use el campo battery_health para ver el estado de la batería.

Valor Descripción
ok Nivel de batería ok
replace Nivel de batería bajo, debe ser reemplazado

Alarma de CO

Use el campo co_alarm_state para ver el estado de la alarma de CO.

Valor Descripción
ok Operación normal
warning Detección de niveles crecientes de CO
emergency Niveles de CO demasiado altos, el usuario debe salir de la casa

Alarma de humo

Use el campo smoke_alarm_state para ver el estado de la alarma de humo.

Valor Descripción
ok Operación normal
warning Detección de niveles de humo en aumento.
emergency Niveles de humo demasiado altos, el usuario debe salir de la casa

Prueba manual

Use estos campos para verificar si una prueba manual de humo o CO está actualmente activa, y la última vez que se realizó una prueba exitosa de humo o CO.

Estado de color de la interfaz de usuario

Para facilitar el diseño de una interfaz de usuario coherente entre productos, proporcionamos el campo ui_color_state , que proporciona una indicación de alto nivel del estado general de Nest Protect. Se deriva de is_online , battery_health , co_alarm_state y smoke_alarm_state , proporcionando una condición agregada que refleja los indicadores de color reales que se muestran en la aplicación Nest .

Error de mensajes

Para obtener información sobre qué significan los errores de llamadas de API y cómo manejarlos, consulte Mensajes de error .