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

API Struktur

Pengguna dapat menambahkan maksimal tiga struktur , dengan beberapa perangkat per struktur.

Semua nilai di bawah ini ditemukan di bawah setiap structures/ structure_id dalam dokumen JSON.

structure_id

Nomor ID dari struktur. Saat Anda melakukan panggilan ke lokasi data ini, Anda dapat mengakses nilai data dalam struktur ini.

Detail
https://developer-api.nest.com/structures/ structure_id /structure_id
Kembali string
Contoh: "VqFabWH21nw ..."
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA write / v1-v2
Kode pos baca / v2
Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4
Energi baca / v2

termostat

Daftar termostat dalam struktur, oleh pengidentifikasi perangkat unik. Ini adalah larik objek JSON yang mencakup semua termostat dalam struktur.

Detail
https://developer-api.nest.com/structures/ structure_id /thermostats
Kembali array
Contoh: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA write / v1-v2
Kamera baca / v2-v3
Kamera membaca + gambar / v2-v4
Kamera baca / tulis / v2-v3
Kamera baca / tulis + gambar / v2-v4

smoke_co_alarms

Daftar alarm asap + CO dalam struktur, oleh pengidentifikasi perangkat unik. Ini adalah larik objek JSON yang mencakup semua alarm asap + CO dalam struktur.

Detail
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
Kembali array
Contoh: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA write / v1-v2
Kamera baca / v2-v3
Kamera membaca + gambar / v2-v4
Kamera baca / tulis / v2-v3
Kamera baca / tulis + gambar / v2-v4

kamera

Daftar kamera dalam struktur, dengan pengidentifikasi perangkat unik. Ini adalah larik objek JSON yang mencakup semua kamera dalam struktur.

Detail
https://developer-api.nest.com/structures/ structure_id /cameras
Kembali array
Contoh: [ "awJo6rH...",... ]
Mengakses hanya baca
Tersedia di Thermostat baca / v4-v6
Thermostat baca / tulis / v4-v6
Asap + CO baca / v4-v5
Jauh baca / v2
Jauh baca / tulis / v2
ETA write / v2
Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

jauh

Menunjukkan status hunian struktur.

Struktur memiliki dua keadaan yang terkait dengan keberadaan: home atau away . Ketika tidak ada gerakan dirasakan di rumah, struktur akan berubah dari home ke away .

Detail
https://developer-api.nest.com/structures/ structure_id /away
Kembali string
Nilai: "rumah", "jauh"
Mengakses Baca tulis
Tersedia di Baca:
Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA write / v1-v2
Menulis:
Jauh baca / tulis / v1-v2

nama

Nama tampilan yang ditentukan pengguna dari struktur.

Detail
https://developer-api.nest.com/structures/ structure_id /name
Kembali string
Contoh: "Rumahku", "Rumah Pantai", "Rumah Gunung"
Mengakses Baca tulis
Tersedia di Baca:
Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA write / v1-v2
Kode pos baca / v2
Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4
Energi baca / v2
Struktur baca / tulis / v1
Menulis:
Struktur baca / tulis / v1

Kode negara

Kode negara, dalam format ISO 3166 alpha-2 .

Detail
https://developer-api.nest.com/structures/ structure_id /country_code
Kembali string
Contoh: "AS", "CA", "Inggris"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA write / v1-v2

Kode Pos

Pos atau kode pos, tergantung negara.

Detail
https://developer-api.nest.com/structures/ structure_id /postal_code
Kembali string
Contoh: "94304", "94304-1027", "EC1A 1BB"
Mengakses hanya baca
Tersedia di Kode pos baca / v1-v2

peak_ Period_start_time

Mulai waktu acara jam sibuk energi , dalam format ISO 8601 .

Detail
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
Kembali string
Contoh: "2016-12-31T23: 59: 59.000Z"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Energi baca / v1-v2

peak_ Period_end_time

Waktu akhir acara jam sibuk energi , dalam format ISO 8601 .

Detail
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
Kembali string
Contoh: "2016-12-31T23: 59: 59.000Z"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Energi baca / v1-v2

zona waktu

Zona waktu pada struktur, dalam format zona waktu IANA .

Detail
https://developer-api.nest.com/structures/ structure_id /time_zone
Kembali string
Contoh: "America / Los_Angeles"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v2
ETA write / v1-v2

eta

ETA (perkiraan waktu kedatangan) adalah objek yang dapat diatur pada struktur. Ini digunakan untuk memberi tahu Nest bahwa pengguna diharapkan untuk kembali ke rumah pada waktu tertentu. Untuk informasi tentang cara melakukan panggilan ETA, lihat Panduan Jauh .

Detail
https://developer-api.nest.com/structures/ structure_id /eta
Kembali object
Contoh: "myTripID1024", "2014-10-31T22: 42: 00.000Z", "2016-12-31T23: 59: 59.000Z"
Parameter
trip_id String yang ditentukan pengguna yang mengidentifikasi perjalanan
estimated_arrival_window_begin Stempel waktu dalam format ISO 8601 .
Harus lebih besar dari NOW .
estimated_arrival_window_end Stempel waktu dalam format ISO 8601 .
Harus lebih besar dari estimated_arrival_window_begin .
Mengakses hanya menulis
Tersedia di ETA write / v1-v2

eta_begin

Stempel waktu perkiraan waktu kedatangan paling awal dalam format ISO 8601 . Digunakan untuk memicu tindakan atau peristiwa.

Detail
https://developer-api.nest.com/structures/ structure_id /eta_begin
Kembali string
Contoh: "2016-12-31T23: 59: 59.000Z"
Mengakses hanya baca
Tersedia di ETA baca / v1

rhr_enrollment

Status pendaftaran Rush Hour Rewards .

Detail
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Energi baca / v1-v2

wwn_security_state

Status keamanan struktur.

Detail
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
Tipe string enum
Nilai: "ok", "deter"
Mengakses hanya baca
Tersedia di Status keamanan baca / v1

dimana

Objek yang berisi pengidentifikasi tempat ( where_id dan name ) untuk perangkat dalam struktur. name adalah name tampilan perangkat. Itu bisa berupa nama kamar apa pun dari daftar yang kami sediakan, atau nama khusus.

Untuk informasi lebih lanjut tentang wheres , lihat Panduan Struktur .

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

Detail
https://developer-api.nest.com/structures/ structure_id /wheres
Kembali object
Mengakses hanya baca
Tersedia di Baca:
Thermostat baca / v3-v6
Thermostat baca / tulis / v3-v6
Asap + CO baca / v3-v5
Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

where_id

Pengidentifikasi unik yang dibuat oleh Nest yang mewakili name .

where_id secara otomatis dibuat dan dikembalikan selama panggilan untuk membuat name .

Detail
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
Kembali string
Contoh: "Fqp6wJI ..."
Mengakses hanya baca
Tersedia di Baca:
Thermostat baca / v3-v6
Thermostat baca / tulis / v3-v6
Asap + CO baca / v3-v5
Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

nama

Nama tampilan perangkat.

Detail
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
Kembali string
Contoh: "Kamar Tidur"
Mengakses Baca tulis
Tersedia di Baca:
Thermostat baca / v3-v6
Thermostat baca / tulis / v3-v6
Asap + CO baca / v3-v5
Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

co_alarm_state

Status alarm CO.

Detail
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
Kembali string enum
Nilai: "ok", "peringatan", "darurat"
Mengakses hanya baca
Tersedia di Asap + CO baca / v5

smoke_alarm_state

Status alarm asap.

Detail
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
Kembali string enum
Nilai: "ok", "peringatan", "darurat"
Mengakses hanya baca
Tersedia di Asap + CO baca / v5