Google is committed to advancing racial equity for Black communities. See how.

Rauch+CO Alarm

Rauch- + CO-Melder

Protect Nest ist so konzipiert , Rauch und Kohlenmonoxid (CO) in einer Wohnumgebung, mit mehreren Sensoren zu erfassen , um es zu verstehen , was in der Heimat passiert.

Das Nest API bietet Zugriff auf die folgenden Daten auf Nest Protect:

  • Alarmstatus Rauch oder Kohlenmonoxid (CO)
  • Batteriezustand
  • Letzter manueller Teststatus und Zeitstempel
  • Online-Status und letzte Verbindungsinformationen
  • Strukturname und Gerät "wo name" (Ort im Haus)

Rauch+CO-Berechtigungen

Für Lesezugriff auf alle Alarm API Datenwerte Smoke + CO, wählen Sie den Rauch + CO lesen Erlaubnis für Ihre Kunden.

Für die Smoke+CO Alarm API sind keine Schreibrechte verfügbar.

Rauch+CO-Identifikatoren

Gerät

Nest-Geräte werden nach Typ als Array von IDs aufgelistet, mit denen ein Gerät über den Gerätepfad eindeutig identifiziert werden kann. So ein Rauch + co Alarm - ID von "RTMTKxs..." bedeutet , dass Sie den Rauch laden + co Alarmgerätemodell an devices/smoke_co_alarms/RTMTKxs... über die API.

Wenn ein Gerät mit mehreren Produkten verbunden ist, sieht jeder Entwickler eine andere ID für dieses Gerät. Bei einem Gerät, auf dem mehrere Produkte desselben Entwicklers installiert sind, wird dem Entwickler dieselbe ID angezeigt.

Name

Es werden zwei Namensattribute bereitgestellt. Das kürzere name - Attribut wird in der Benutzeroberfläche Etikett angezeigt, während name_long in Langform Text verwendet wird.

name

In diesem Beispiel name ist "Nest Protect".

Name

name_long

In diesem Beispiel name_long ist „Keller Nest Protect“.

Name lang

Wo

where_id

  • Ein einzigartiger, Nest-generierten Identifikator, der darstellt , name
  • where_id ist schreibgeschützt und wird automatisch in dem Aufruf erstellt , um eine benutzerdefinierte zu erstellen , in dem name

Erfahren Sie mehr darüber , wo Namen für Nest Thermostats ,Nest schützt und Nest Cams .

where_name

Wenn Sie sich für die Smoke + CO Leseberechtigung können Sie das Gerät zugreifen where_name aus dem Geräteobjekt ( devices/smoke_co_alarms ).

Andere Metadaten

Alle Datenwerte sind schreibgeschützt, sofern nicht anders angegeben.

Datenwert Beschreibung
locale Der diesem Gerät zugewiesene Sprach- und Ländercode
software_version Eine Zeichenfolge, die die aktuell auf dem Gerät installierte Firmware darstellt
structure_id Eine Zeichenfolge, die diese Struktur eindeutig darstellt; Dies ist die Struktur, mit der das Gerät gekoppelt ist
last_connection Der Zeitstempel der letzten erfolgreichen Verbindung zum Nest-Dienst
is_online Online Status. Dies wird durch Nest unter Verwendung der bestimmten last_connection Zeit und einer erwarteten Neuverbindung Fenster , das gerätespezifisch ist.

Smoke+CO-Funktionen

Batteriezustand

Verwenden Sie das battery_health Feld den Akkuzustand Zustand anzuzeigen.

Wert Beschreibung
ok Akkustand ok
replace Batteriestand niedrig, sollte ersetzt werden

CO-Alarm

Verwenden Sie das co_alarm_state Feld den CO Alarmzustand anzuzeigen.

Wert Beschreibung
ok Normale Operation
warning Erkennung steigender CO-Werte
emergency CO-Werte zu hoch, Benutzer sollte das Haus verlassen

Rauchmelder

Verwenden Sie das smoke_alarm_state Feld , um den Rauchalarmzustand anzuzeigen.

Wert Beschreibung
ok Normale Operation
warning Erkennung steigender Rauchwerte
emergency Rauchpegel zu hoch, Benutzer sollte das Haus verlassen

Manueller Test

Verwenden Sie diese Felder, um zu überprüfen, ob derzeit ein manueller Rauch- oder CO-Test aktiv ist und wann zuletzt ein erfolgreicher Rauch- oder CO-Test durchgeführt wurde.

UI-Farbstatus

Um es einfacher zu gestalten , ein kohärentes UI Kreuzprodukt, haben wir das mitgelieferte ui_color_state Feld, das einen hochrangigen Hinweis auf dem Gesamtzustand des Nests gibt Protect. Es ist aus der abgeleiteten is_online , battery_health , co_alarm_state und smoke_alarm_state , eine Aggregatzustand bereitstellt, die die tatsächlichen Farbindikatoren angezeigt im reflektiert Nest App .

Fehlermeldungen

Für Informationen darüber , was API - Aufruf Fehler bedeuten und wie sie zu behandeln, siehe Fehlermeldungen .