Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Struktur

Struktur

Struktur sarang mewakili struktur fisik di dunia nyata. Biasanya rumah pengguna, mereka berfungsi sebagai titik pengorganisasian untuk perangkat dan akan menyimpan data yang berlaku untuk seluruh rumah.

The Nest API menyediakan akses ke data struktur tingkat berikut, tergantung pada tingkat izin yang diberikan:

  • Struktur nama dan perangkat "where name" (lokasi di rumah)
  • Daftar perangkat di rumah
  • Energi acara Status ( energi jam sibuk )
  • Status tandang
  • ETA pengguna
  • Status keamanan
  • Kode pos atau kode pos

Beberapa fitur tingkat struktur tercakup dalam panduan API yang lebih detail dan terpisah:

Izin struktur

Untuk akses ke... Pilih...
Kebanyakan nilai-nilai data dalam structures objek Pergi , ETA , Energi , atau Kode pos perizinan
The name nilai data dalam structures objek Struktur read / write izin

Lihat bagaimana izin bekerja di API Referensi interaktif .

Pengidentifikasi struktur

Nama

Nama struktur defaultnya adalah "Beranda" tetapi dapat berupa string apa pun yang dipilih pengguna. Bila Anda memilih Struktur baca / tulis izin, Anda dapat mengubah struktur name .

Dimana

wheres adalah seperangkat objek pada struktur, yang mengandung mana pengidentifikasi ( where_id dan name ). Gunakan wheres untuk membuat kustom di mana nama, atau akses standar di mana nama.

Akses ke wheres objek membutuhkan Camera , asap + CO Alarm , atau Thermostat perizinan.

where_id

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

name

  • Nama tampilan perangkat; bisa nama kamar apa saja dari daftar yang kami sediakan, atau nama khusus
  • Untuk membuat custom mana name , membuat panggilan POST untuk menulis baru, kustom mana name ; yang where_id dikembalikan dalam panggilan
  • Pertimbangan
    • name tidak dapat diedit atau dihapus setelah penciptaan
    • name harus unik dalam struktur
    • Jika perangkat dipasangkan ke struktur, kebiasaan di mana name dikaitkan dengan perangkat dapat diakses dari /structures/ path
    • Untuk memindahkan perangkat dengan kustom mana name untuk struktur yang berbeda, membatalkan penyandingan perangkat, dan kemudian memasangkan-ulang perangkat dengan nama yang diinginkan

Pelajari lebih lanjut tentang nama untuk Termostat Nest ,Nest Melindungi dan Nest Cams .

Metadata lainnya

Semua nilai data hanya dapat dibaca, kecuali ditentukan lain.

Nilai Data Deskripsi
structure_id String yang secara unik mewakili struktur ini. Setiap pengembang akan melihat ID yang berbeda untuk struktur yang sama, tetapi beberapa produk dari pengembang yang sama akan melihat ID yang sama
country_code Kode negara ISO 3166-1 alpha-2 yang memetakan ke lokasi terdaftar dari struktur
postal_code Kode pos atau kode pos, tergantung negaranya
time_zone Sebuah IANA zona waktu string yang memetakan ke zona waktu struktur ini

Fitur struktur

Status alarm asap dan CO

Bila Anda memilih asap + CO membaca izin , Anda dapat mengakses smoke_alarm_state dan co_alarm_state di structures objek. Nilai-nilai ini data yang sama juga tersedia di objek perangkat ( devices/smoke_co_alarms ).

Lihat Asap + panduan alarm CO untuk informasi lebih lanjut tentang negara-negara ini.

Banyak nilai data bekerja sama untuk menentukan bagaimana perangkat berperilaku dalam suatu struktur.

  • Ketika struktur away negara diatur untuk away kata "ECO" ditampilkan pada Nest Thermostat, dalam bahasa pilihan pengguna
  • Ketika struktur away negara diatur untuk away , Anda dapat:
    • set fan_timer_active
    • Perubahan target_temperature_f atau target_temperature_c
  • Ketika struktur away negara diatur ke home , Anda dapat:
    • lakukan panggilan ETA (setel id perjalanan dan jendela kedatangan)
  • Ketika Darurat Sakelar aktif, Anda tidak dapat mengatur fan_timer_active
  • Ketika Panas Darurat diaktifkan, Anda tidak dapat dapat mengatur struktur untuk away

Beberapa struktur

Ada kemungkinan pengguna memiliki lebih dari satu struktur yang dilampirkan ke Akun Nest mereka, jadi produk Anda harus menawarkan cara bagi pengguna untuk memilih dari struktur yang tersedia (pemilih struktur).

Pemilih struktur

Misalnya, saat menyetel ETA, penting bagi pengguna untuk dapat memilih struktur untuk tujuan ETA. Dengan cara yang sama, seorang pengguna dapat memiliki dua detektor asap di "ruang tamu" dari dua rumah yang berbeda. Jika Anda perlu melakukan korelasi struktur dengan konsep rumah Anda sendiri, kami sarankan Anda melakukannya selama proses otorisasi.

Pelajari cara pengguna mengelola perangkat dalam beberapa struktur .

Maksimum perangkat

Ada batasan jumlah perangkat yang didukung Nest dalam suatu struktur.

Tipe perangkat Maks per struktur
Termostat Sarang 20
Kamera Sarang 10
pelindung sarang 18

Pesan kesalahan

Untuk informasi tentang apa kesalahan API panggilan berarti dan bagaimana untuk menangani mereka, lihat Pesan Kesalahan .