Google致力於提高黑人社區的種族平等。 怎麼看。
本頁面由 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調用錯誤的含義以及如何處理錯誤的信息 ,請參見錯誤消息