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.
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

煙霧+ CO報警

煙霧+ CO警報

Nest Protect旨在檢測住宅環境中的煙霧和一氧化碳(CO),並具有多個傳感器以幫助其了解家庭中發生的事情。

Nest API可讓您訪問Nest Protect上的以下數據:

  • 煙霧或一氧化碳(CO)警報狀態
  • 電池健康狀態
  • 上次手動測試狀態和時間戳
  • 聯機狀態和上次連接信息
  • 結構名稱和設備“位置名稱”(家庭中的位置)

Smoke + CO權限

要對所有Smoke + CO警報API數據值進行讀取訪問, 為您的客戶端選擇Smoke + CO讀取權限。

Smoke + CO警報API沒有可用的寫權限。

Smoke + CO標識符

設備

嵌套設備按類型列出為ID數組,可用於通過設備路徑唯一標識設備。因此,煙霧+聯合警報ID為"RTMTKxs..."意味著您可以通過API在devices/smoke_co_alarms/RTMTKxs...上加載煙霧+聯合警報設備模型。

當設備連接到多個產品時,每個開發人員將看到該設備的不同ID。對於已安裝來自同一開發人員的多個產品的設備,開發人員將看到相同的ID。

名稱

提供了兩個名稱屬性。較短的name屬性顯示在用戶界面標籤中,而name_long用於長格式文本。

name

在此示例中, name為“嵌套保護”。

名稱

name_long

在此示例中, name_long是“ Basement Nest Protect”。

名字長

哪裡

where_id

  • 由Nest生成的唯一標識符,代表name
  • where_id是只讀的,並且會在調用中自動創建以創建自定義where name

詳細了解Nest ThermostatsNest ProtectsNest Cams的名稱

where_name

選擇Smoke + CO讀取許可權後 ,可以從設備對象( devices/smoke_co_alarms )訪問設備where_name

其他元數據

除非另有說明,否則所有數據值都是只讀的。

資料值描述
locale 分配給此設備的語言和國家/地區代碼
software_version 代表設備當前安裝的固件的字符串
structure_id 一個唯一表示此結構的字符串;這是設備與之配對的結構
last_connection 上次成功連接Nest服務的時間戳
is_online 聯機狀態。這是由Nest使用last_connection時間和特定於設備的預期重新連接窗口確定的。

煙霧+ CO功能

電池健康

使用battery_health字段查看電池的健康狀態。

描述
ok 電池電量正常
replace 電池電量不足,應更換

一氧化碳報警器

使用co_alarm_state字段查看CO警報狀態。

描述
ok 普通手術
warning 檢測上升的一氧化碳水平
emergency CO水平過高,用戶應離開家

煙霧報警器

使用smoke_alarm_state字段查看煙霧警報狀態。

描述
ok 普通手術
warning 檢測煙霧水平上升
emergency 煙霧水平過高,用戶應離開家

手動測試

使用這些字段來檢查當前是否正在進行手動煙氣或一氧化碳測試,以及最後一次成功進行煙氣或一氧化碳測試的時間。

UI顏色狀態

為了ui_color_state設計一致的跨產品UI的過程,我們提供了ui_color_state字段,該字段從高級角度指示Nest Protect的總體狀態。它是從is_onlinebattery_healthco_alarm_statesmoke_alarm_state ,提供了一個匯總條件,可以反映Nest應用程序中顯示的實際顏色指示器。

錯誤訊息

有關什麼是API調用錯誤的含義以及如何處理錯誤的信息 ,請參見錯誤消息