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.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Rauch + CO Alarm

Rauch + CO Alarm

Nest Protect wurde entwickelt, um Rauch und Kohlenmonoxid (CO) in Wohngebieten zu erkennen. Mehrere Sensoren helfen dabei, die Vorgänge im Haushalt zu verstehen.

Die Nest-API bietet Zugriff auf die folgenden Daten in Nest Protect:

  • Alarmstatus für Rauch oder Kohlenmonoxid (CO)
  • Zustand der Batterie
  • Letzter manueller Teststatus und Zeitstempel
  • Online-Status und letzte Verbindungsinformationen
  • Strukturname und Gerät "wo Name" (Ort im Haus)

Rauch + CO-Berechtigungen

Wählen Sie für den Lesezugriff auf alle Smoke + CO-Alarm-API-Datenwerte die Leseberechtigung Smoke + CO für Ihren Client aus.

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

Rauch + CO-Kennungen

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. Eine Rauch + Co-Alarm-ID von "RTMTKxs..." bedeutet also, dass Sie das Rauch + Co-Alarm-Gerätemodell über die API unter devices/smoke_co_alarms/RTMTKxs... .

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 wurden, 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 lautet der name "Nest Protect".

Name

name_long

In diesem Beispiel name_long "Basement Nest Protect".

Name lang

Wo

where_id

  • Eine eindeutige, von Nest generierte Kennung, die den name
  • where_id ist schreibgeschützt und wird beim Aufruf automatisch erstellt, um einen benutzerdefinierten where- name zu erstellen

Erfahren Sie mehr darüber, wo Namen für Nest-Thermostate , Nest-Schutz und Nest-Kameras stehen .

where_name

Wenn Sie die Leseberechtigung Smoke + CO auswählen, können where_name über das Geräteobjekt ( devices/smoke_co_alarms ) auf das Gerät where_name devices/smoke_co_alarms .

Andere Metadaten

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

Datenwert Beschreibung
locale Die diesem Gerät zugewiesene Sprache und der 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 von Nest anhand der last_connection Zeit und eines erwarteten Wiederverbindungsfensters bestimmt, das gerätespezifisch ist.

Rauch + CO-Funktionen

Batteriezustand

Verwenden Sie das battery_health Feld den Akkuzustand Zustand anzuzeigen.

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

CO-Alarm

Verwenden Sie das Feld co_alarm_state , um den CO-Alarmstatus 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 Feld smoke_alarm_state , um den Rauchmelderstatus smoke_alarm_state .

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.

Farbstatus der Benutzeroberfläche

Um das Entwerfen einer kohärenten ui_color_state Benutzeroberfläche zu vereinfachen, haben wir das Feld ui_color_state bereitgestellt, das einen allgemeinen Hinweis auf den Gesamtstatus des Nest Protect gibt. Es wird von is_online , battery_health , co_alarm_state und smoke_alarm_state und bietet eine aggregierte Bedingung, die die tatsächlichen Farbindikatoren widerspiegelt, die in der Nest-App angezeigt werden.

Fehlermeldungen

Informationen dazu, was API-Aufruffehler bedeuten und wie sie behandelt werden, finden Sie unter Fehlermeldungen .