Notice: We're retiring Works with Nest. See the home page for more information.
Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
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 di dokumen JSON.

structure_id

Nomor ID 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 dalam Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA tulis / v1-v2
Kode pos membaca / v2
Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4
Energi membaca / v2

termostat

Daftar termostat dalam struktur, dengan pengenal 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 dalam Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA tulis / v1-v2
Kamera membaca / v2-v3
Kamera membaca + gambar / v2-v4
Kamera baca / tulis / v2-v3
Kamera membaca / menulis + gambar / v2-v4

smoke_co_alarms

Daftar alarm asap + CO dalam struktur, dengan pengenal perangkat unik. Ini adalah larik objek JSON yang menyertakan 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 dalam Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA tulis / v1-v2
Kamera membaca / v2-v3
Kamera membaca + gambar / v2-v4
Kamera baca / tulis / v2-v3
Kamera membaca / menulis + gambar / v2-v4

kamera

Daftar kamera dalam struktur, menurut pengenal perangkat unik. Ini adalah larik objek JSON yang menyertakan semua kamera dalam struktur.

Detail
https://developer-api.nest.com/structures/ structure_id /cameras
Kembali array
Contoh: [ "awJo6rH...",... ]
Mengakses hanya baca
Tersedia dalam Termostat membaca / v4-v6
Baca / tulis termostat / v4-v6
Asap + CO baca / v4-v5
Jauh baca / v2
Jauh baca / tulis / v2
ETA tulis / v2
Kamera membaca / 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 kehadiran: 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 dalam Baca baca:
Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA tulis / v1-v2
Menulis:
Jauh baca / tulis / v1-v2

nama

Nama tampilan struktur yang ditentukan pengguna.

Detail
https://developer-api.nest.com/structures/ structure_id /name
Kembali string
Contoh: "Rumah Saya", "Rumah Pantai", "Rumah Gunung"
Mengakses Baca tulis
Tersedia dalam Baca baca:
Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA tulis / v1-v2
Kode pos membaca / v2
Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4
Energi membaca / 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: "US", "CA", "UK"
Mengakses hanya baca
Tersedia dalam Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v1-v2
ETA tulis / v1-v2

kode Pos

Kode pos atau pos, tergantung negaranya.

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

peak_period_start_time

Waktu mulai 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 dalam Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Energi membaca / v1-v2

peak_period_end_time

Waktu berakhir 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 dalam Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Energi membaca / 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 dalam Termostat membaca / v1-v6
Baca / tulis termostat / v1-v6
Asap + CO baca / v1-v5
Jauh baca / v1-v2
Jauh baca / tulis / v2
ETA tulis / v1-v2

eta

ETA (perkiraan waktu kedatangan) adalah suatu objek yang dapat diatur pada suatu 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 buatan 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 tulis
Tersedia dalam ETA tulis / 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 dalam ETA baca / v1

rhr_enrollment

Status pendaftaran Hadiah Jam Sibuk.

Detail
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Energi membaca / 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 dalam Status keamanan baca / v1

dimana

Objek yang berisi where identifiers ( where_id and name ) untuk perangkat dalam struktur. name adalah name tampilan perangkat. Bisa 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 TermostatNest , PerlindunganNest , dan Nest Cam .

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

where_id

Pengenal unik buatan 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 dalam Baca baca:
Pembacaan termostat / v3-v6
Baca / tulis termostat / v3-v6
Asap + CO baca / v3-v5
Kamera membaca / 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 dalam Baca baca:
Pembacaan termostat / v3-v6
Baca / tulis termostat / v3-v6
Asap + CO baca / v3-v5
Kamera membaca / 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 dalam 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 dalam Asap + CO baca / v5