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

Humo + CO Alarma

Humo de alarma + CO

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

La API Nido proporciona acceso a los siguientes datos en el Nest Protect:

  • El humo o monóxido de carbono (CO) de estado de alarma
  • Estado de salud de la batería
  • Última estado de la prueba manual y marca de tiempo
  • El estado de conexión y la información de la última conexión
  • nombre de la estructura y el dispositivo "en nombre" (lugar de la casa)

Humo permisos + CO

Para acceso de lectura a todos los valores de datos de la API de alarma de humo + CO, seleccione el Humo + CO leer el permiso para su cliente.

No hay permisos de escritura para el Humo + CO API de alarma.

Humo identificadores + CO

Dispositivo

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

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

Nombre

Se proporcionan dos atributos de nombre. Cuanto más corto sea name de atributo se muestra en las etiquetas de la interfaz de usuario, mientras que name_long se utiliza en texto largo formulario.

name

En este ejemplo, 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 Nest-que representa name
  • where_id es de sólo lectura, y se crea automáticamente en la llamada para crear una costumbre en name

Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

where_name

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

otros metadatos

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

Valor de los datos Descripción
locale El código de idioma y el país asignada a este dispositivo
software_version Una cadena que representa el firmware instalada actualmente en el dispositivo
structure_id Una cadena que representa de forma única esta estructura; esta es la estructura que el dispositivo está emparejado con
last_connection La fecha y hora de la última conexión correcta con el servicio Nido
is_online Estado en línea. Esto se determina por Nest usando el last_connection tiempo y una ventana de reconexión de esperar que es un dispositivo específico.

Humo Características + CO

estado de la batería

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

Valor Descripción
ok ok nivel de la batería
replace nivel de batería baja, debe ser reemplazado

alarma de CO

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

Valor Descripción
ok Operación normal
warning La detección de aumento de los niveles de CO
emergency Los niveles de CO demasiado alta, el usuario debe salir de la casa

Alarma de humo

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

Valor Descripción
ok Operación normal
warning La detección del aumento de los niveles de humo
emergency Los niveles de humo demasiado alta, el usuario debe salir de la casa

Prueba manual

Utilice estos campos para comprobar si un humo manual o prueba de CO se activa, y la última vez que se realizó una prueba de humo de tabaco o CO.

estado de color UI

Para que sea más fácil el diseño de una interfaz de usuario a través del producto coherente, hemos proporcionado el ui_color_state campo, lo que da una indicación de alto nivel del estado general del Nest Protect. Se deriva de is_online , battery_health , co_alarm_state , y smoke_alarm_state , proporcionando una condición de agregado que refleja los indicadores de color reales que aparecen en la aplicación Nest .

Error de mensajes

Para obtener información sobre lo que los errores de llamada a la API significan y cómo manejarlos, ver los mensajes de error .