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警報API

Nest API適用於所有Nest Protect™煙霧+一氧化碳警報模型。

用戶可以將多個Nest Protects添加到devices/smoke_co_alarms組, 每個結構最多可以添加一個。呼叫此數據位置時,可以訪問Nest Protect數據(結構中設備的數據值)。

以下所有值均位於JSON文檔中的每個devices/smoke_co_alarms/ device_id

設備編號

Nest Protect唯一標識符。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /device_id
退貨 string
示例:“ RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

地區

指定語言和地區(或國家)首選項。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /locale
退貨 string
示例:“ en-GB”,“ en-US”,“ es-US”,“ fr-CA”,“ fr-CA”,“ nl-NL”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

軟件版本

軟件版本。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /software_version
退貨 string
示例:“ 1.0.1”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

structure_id

結構唯一標識符。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /structure_id
退貨 string
示例:“ VqFabWH21nw ...”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

名稱

顯示設備名稱;可以是我們提供的列表中的任何房間名稱,也可以是自定義名稱。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /name
退貨 string
示例:“走廊”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

name_long

設備的長顯示名稱。包括由用戶或通過wheres創建的自定義(標籤)。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /name_long
退貨 string
示例:“走廊保護(樓上)”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

last_connection

上一次成功與Nest服務互動的時間戳記,格式為ISO 8601

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /last_connection
退貨 string
示例:“ 2016-12-31T23:59:59.000Z”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

在線

Nest服務的設備連接狀態。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_online
退貨 boolean
值:true,false
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

電池健康

電池壽命/健康狀況;估計剩餘電池電量。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /battery_health
退貨 string enum
值:“確定”,“替換”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

co_alarm_state

一氧化碳(CO)警報狀態。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /co_alarm_state
退貨 string enum
值:“確定”,“警告”,“緊急”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

smoke_alarm_state

煙霧警報狀態。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /smoke_alarm_state
退貨 string enum
值:“確定”,“警告”,“緊急”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

is_manual_test_active

手動煙霧和CO警報測試的狀態。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_manual_test_active
退貨 boolean
值:true,false
訪問 只讀
可用於 煙霧+ CO讀取/ v2-v5

last_manual_test_time

上次成功進行手動煙霧和CO警報測試的時間戳,採用ISO 8601格式。

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /last_manual_test_time
退貨 string
示例:“ 2016-12-31T23:59:59.000Z”
訪問 只讀
可用於 煙霧+ CO讀取/ v2-v5

ui_color_state

在Nest應用程序用戶界面中通過顏色指示設備狀態。這是電池+煙+ CO狀態的匯總條件,反映了Nest應用程序中顯示的實際顏色指示器。

有關顏色指示器的更多信息,請參閱Nest Protect指示燈Nest Protect電池電量

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /ui_color_state
退貨 string enum
值:“灰色”,“綠色”,“黃色”,“紅色”
訪問 只讀
可用於 煙霧+ CO讀取/ v1-v5

where_id

唯一的,由Nest生成的標識符,代表name ,即設備的顯示名稱。

詳細了解Nest ThermostatsNest ProtectsNest Cams的名稱

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_id
退貨 string
示例:“ d6reb_OZTM ...”
訪問 只讀
可用於 煙霧+ CO讀取/ v3-v5

where_name

設備的顯示名稱。與Nest Protect where_id 。可以是我們提供的列表中的任何房間名稱,也可以是自定義名稱。詳細了解Nest ThermostatsNest ProtectsNest Cams的名稱

細節
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_name
退貨 string
示例:“走廊”
訪問 只讀
可用於 煙霧+ CO讀取/ v5