Notice: We're retiring Works with Nest. See the home page for more information.
Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 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