Google berkomitmen untuk memajukan ekuitas ras untuk komunitas kulit hitam. Lihat bagaimana.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Asap + CO Alarm

Alarm asap + CO

Nest Protect dirancang untuk mendeteksi asap dan karbon monoksida (CO) di lingkungan perumahan, dengan beberapa sensor untuk membantu memahami apa yang terjadi di rumah.

Nest API menyediakan akses ke data berikut tentang Nest Protect:

  • Status alarm asap atau karbon monoksida (CO)
  • Status kesehatan baterai
  • Status tes manual terakhir dan cap waktu
  • Status online dan informasi koneksi terakhir
  • Nama struktur dan perangkat "di mana nama" (lokasi di rumah)

Izin asap + CO

Untuk akses baca ke semua nilai data API Smoke + CO alarm, pilih izin baca Smoke + CO untuk klien Anda.

Tidak ada izin tulis yang tersedia untuk API alarm Smoke + CO.

Pengidentifikasi asap + CO

Alat

Perangkat Nest dicantumkan berdasarkan jenis sebagai array ID, yang dapat digunakan untuk mengidentifikasi perangkat secara unik melalui jalur perangkat. Jadi ID asap + co alarm "RTMTKxs..." berarti bahwa Anda dapat memuat model perangkat smoke + co alarm di devices/smoke_co_alarms/RTMTKxs... melalui API.

Ketika perangkat terhubung ke beberapa produk, setiap pengembang akan melihat ID yang berbeda untuk perangkat itu. Untuk perangkat yang telah menginstal banyak produk dari pengembang yang sama, pengembang akan melihat ID yang sama.

Nama

Dua atribut nama disediakan. Atribut name lebih pendek ditampilkan dalam label antarmuka pengguna, sementara name_long digunakan dalam teks formulir panjang.

name

Dalam contoh ini, name adalah "Nest Nest".

Nama

name_long

Dalam contoh ini, name_long adalah "Basement Nest Protect".

Nama panjang

Dimana

where_id

  • Pengidentifikasi unik yang dibuat oleh Nest yang mewakili name
  • where_id read-only, dan dibuat secara otomatis dalam panggilan untuk membuat custom mana name

Pelajari lebih lanjut tentang di mana nama untuk Termostat Sarang , Perlindungan Sarang , dan Sarang Cams .

where_name

Ketika Anda memilih izin membaca Smoke + CO , Anda dapat mengakses perangkat where_name dari objek perangkat ( devices/smoke_co_alarms ).

Metadata lainnya

Semua nilai data hanya baca, kecuali ditentukan lain.

Nilai Data Deskripsi
locale Bahasa dan kode negara yang ditetapkan untuk perangkat ini
software_version String yang mewakili firmware yang saat ini diinstal pada perangkat
structure_id String yang secara unik mewakili struktur ini; ini adalah struktur yang dipasangkan dengan perangkat
last_connection Stempel waktu koneksi terakhir yang berhasil ke layanan Nest
is_online Status online. Ini ditentukan oleh Nest menggunakan waktu last_connection dan jendela koneksi ulang yang diharapkan adalah khusus perangkat.

Fitur asap + CO

Kesehatan baterai

Gunakan bidang battery_health untuk melihat status kesehatan baterai.

Nilai Deskripsi
ok Level baterai ok
replace Level baterai rendah, harus diganti

CO alarm

Gunakan bidang co_alarm_state untuk melihat status alarm CO.

Nilai Deskripsi
ok Operasi normal
warning Deteksi kenaikan level CO
emergency Level CO terlalu tinggi, pengguna harus keluar dari rumah

Alarm asap

Gunakan bidang smoke_alarm_state untuk melihat status alarm asap.

Nilai Deskripsi
ok Operasi normal
warning Deteksi peningkatan kadar asap
emergency Tingkat asap terlalu tinggi, pengguna harus keluar rumah

Tes manual

Gunakan bidang ini untuk memeriksa apakah asap manual atau tes CO saat ini aktif, dan terakhir kali tes asap atau CO berhasil dilakukan.

Keadaan warna UI

Untuk membuatnya lebih mudah untuk merancang UI lintas produk yang koheren, kami telah menyediakan bidang ui_color_state , yang memberikan indikasi tingkat tinggi dari keseluruhan kondisi Nest Nest. Ini berasal dari is_online , battery_health , co_alarm_state , dan smoke_alarm_state , menyediakan kondisi agregat yang mencerminkan indikator warna aktual yang ditampilkan di aplikasi Nest .

Pesan kesalahan

Untuk informasi tentang arti kesalahan panggilan API dan cara menanganinya, lihat Pesan Kesalahan .