Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

API di allarme fumo + CO

L'API Nest funziona con tutti i modelli di allarme fumo + monossido di carbonio Nest Protect ™.

Gli utenti possono aggiungere più Nest devices/smoke_co_alarms gruppo devices/smoke_co_alarms , fino al massimo per struttura . Quando si effettua una chiamata a questa posizione dei dati, è possibile accedere ai dati Nest Protect (valori dei dati per i dispositivi nella struttura).

Tutti i valori seguenti si trovano sotto ciascun devices/smoke_co_alarms/ device_id nel documento JSON.

ID del dispositivo

Identificatore univoco Nest Protect.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /device_id
ritorna string
Esempio: "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

località

Specifica la lingua e la regione (o paese) preferenza.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /locale
ritorna string
Esempi: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

versione software

Versione software.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /software_version
ritorna string
Esempio: "1.0.1"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

structure_id

Identificatore univoco della struttura.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /structure_id
ritorna string
Esempio: "VqFabWH21nw ..."
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

nome

Visualizza il nome del dispositivo; può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /name
ritorna string
Esempio: "Corridoio"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

NAME_LONG

Nome visualizzato lungo del dispositivo. Include un personalizzato (etichetta), creata dall'utente, o tramite wheres .

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /name_long
ritorna string
Esempio: "Hallway Protect (sopra)"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

last_connection

Data / ora dell'ultima interazione riuscita con il servizio Nest, in formato ISO 8601 .

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /last_connection
ritorna string
Esempio: "2016-12-31T23: 59: 59.000Z"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

è in linea

Stato della connessione del dispositivo con il servizio Nest.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_online
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

battery_health

Durata / salute della batteria; stima del livello di carica residua della batteria.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /battery_health
ritorna string enum
Valori: "ok", "sostituisci"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

co_alarm_state

Stato di allarme del monossido di carbonio (CO).

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /co_alarm_state
ritorna string enum
Valori: "ok", "avviso", "emergenza"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

smoke_alarm_state

Stato dell'allarme fumo.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /smoke_alarm_state
ritorna string enum
Valori: "ok", "avviso", "emergenza"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

is_manual_test_active

Stato del test manuale di fumo e CO.

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_manual_test_active
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Fumo + CO read / v2-v5

last_manual_test_time

Data / ora dell'ultimo test manuale di allarme fumo e CO riuscito, in formato ISO 8601 .

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /last_manual_test_time
ritorna string
Esempio: "2016-12-31T23: 59: 59.000Z"
Accesso sola lettura
Disponibile in Fumo + CO read / v2-v5

ui_color_state

Indica lo stato del dispositivo in base al colore nell'interfaccia utente dell'app Nest. È una condizione aggregata per gli stati batteria + fumo + CO e riflette gli indicatori di colore effettivi visualizzati nell'app Nest.

Per ulteriori informazioni sugli indicatori di colore, consulta le spie Nest Protect e il livello della batteria Nest Protect .

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /ui_color_state
ritorna string enum
Valori: "grigio", "verde", "giallo", "rosso"
Accesso sola lettura
Disponibile in Fumo + CO read / v1-v5

where_id

Un identificatore univoco, generato da Nest, che rappresenta il name , il nome visualizzato del dispositivo.

Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_id
ritorna string
Esempio: "d6reb_OZTM ..."
Accesso sola lettura
Disponibile in Fumo + CO read / v3-v5

where_name

Il nome visualizzato del dispositivo. Associato a Nest Protect where_id . Può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato. Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .

Dettagli
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_name
ritorna string
Esempio: "Corridoio"
Accesso sola lettura
Disponibile in Fumo + CO lettura / v5