Notice: We're retiring Works with Nest. See the home page for more information.

Halaman ini diterjemahkan oleh Cloud Translation API.

API termostat

Nest API berfungsi dengan semua model Nest Learning ThermostatTM, kecuali untuk Thermostat E dengan Heat Link di EU.

Pengguna dapat menambahkan beberapa Nest Thermostat ke grup devices/thermostats, hingga maksimum per struktur. Saat melakukan panggilan ke lokasi data ini, Anda dapat mengakses data Nest Thermostat (nilai data untuk perangkat dalam struktur).

Semua nilai di bawah ini ditemukan pada setiap devices/thermostats/device_id dalam dokumen JSON.

ID_perangkat

ID unik Nest Thermostat.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/device_id`
Hasil	`string` Contoh: "peyiJNo0IldT2YlIVtYaGQ"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

locale

Menentukan preferensi bahasa dan wilayah (atau negara).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/locale`
Hasil	`string` Contoh: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

versi_software

Versi software.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/software_version`
Hasil	`string` Misalnya: "4,0"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

struktur_id

Menyusun ID unik.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/structure_id`
Hasil	`string` Contoh: "VqFabWH21nw..."
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

nama

Nama tampilan perangkat. Dapat berupa nama ruang apa pun dari daftar yang kami berikan, atau nama kustom.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/name`
Hasil	`string` Contoh: "Hallway"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

nama_panjang

Nama tampilan panjang perangkat. Mencakup label (label) kustom, yang dibuat oleh pengguna, atau melalui wheres.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/name_long`
Hasil	`string` Misalnya: "Termostat Thermostat (uptairs)"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

koneksi_terakhir

Stempel waktu interaksi terakhir yang berhasil dengan layanan Nest, dalam format ISO 8601.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/last_connection`
Hasil	`string` Contoh: "2016-12-31T23:59:59.000Z"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

is_online [online]

Status koneksi perangkat dengan layanan Nest.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/is_online`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

bisa_keren

Kemampuan sistem untuk mendinginkan (memiliki AC).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/can_cool`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

kalor_panas

Kemampuan sistem untuk menghangatkan.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/can_heat`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

menggunakan_emergency_heat

Status Hangat Darurat dalam sistem dengan pompa kalor untuk pendingin.

Saat Sistem Pemanas Darurat aktif:

Pengguna dapat menyesuaikan suhu target di perangkat, tetapi tidak dapat mengubah mode hingga Sistem Pemanas Darurat dinonaktifkan
hvac_mode masih dapat diubah melalui API

Lihat Apa itu Batas Darurat ? untuk informasi selengkapnya tentang cara Nest Thermostat mendukung Sistem Pemanas Darurat.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

punya_penggemar

Kemampuan sistem untuk mengontrol kipas secara independen dari penghangat atau pendingin.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/has_fan`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

kipas_waktu_aktif

Menunjukkan apakah timer kipas berinteraksi; digunakan dengan fan_timer_duration untuk mengaktifkan kipas selama durasi preset yang ditentukan pengguna.

Baca bagian Kontrol Penggemar Lanjutan untuk mengetahui informasi lebih lanjut tentang cara pelanggan menetapkan durasi kipas.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

kipas_waktu_waktu_habis

Stempel waktu yang muncul saat timer kipas mencapai 0 (waktu berhenti), dalam format ISO 8601.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout`
Hasil	`string` Contoh: "2016-12-31T23:59:59.000Z"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

punya_daun

Ditampilkan saat termostat disetel ke suhu hemat energi.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/has_leaf`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

skala_suhu

Fahrenheit atau Celsius; digunakan dengan tampilan suhu.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale`
Hasil	`string enum` Nilai: "F", "C"
Akses	baca/tulis
Tersedia di	Baca: Pembacaan termostat / v1-v6 Pembacaan/penulisan Thermostat / v1-v6 Tulis: Pembacaan termostat/tulis / v5-v6

suhu_target_f

Suhu yang diinginkan, dalam derajat penuh Fahrenheit (1°F). Digunakan saat hvac_mode = heat atau cool.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f`
Hasil	`number` Contoh: 72
Rentang	50-90
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

suhu_target_c

Suhu yang diinginkan, dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = heat atau cool.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c`
Hasil	`number` Contoh: 21,5
Rentang	9-32
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

suhu_target_tinggi_f

Suhu target maksimum, ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat hvac_mode = heat-cool (Tingkatan •Mode dingin).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f`
Hasil	`number` Contoh: 80
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

suhu_target_tinggi_c

Suhu target maksimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = heat-cool (Heat•Mode dingin).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c`
Hasil	`number` Contoh: 24,5
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

target_temperature_low_f

Suhu target minimum, yang ditampilkan dalam derajat derajat Fahrenheit (1°F). Digunakan saat hvac_mode = heat-cool (Tingkatan •Mode dingin).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f`
Hasil	`number` Contoh: 65
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

suhu_target_rendah_c

Suhu target minimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = heat-cool (Heat•Mode dingin).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c`
Hasil	`number` Misalnya: 19,5
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

eco_temperature_high_f

Suhu Hemat Energi Maksimum, ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat hvac_mode = eco.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f`
Hasil	`number` Contoh: 80
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

eco_temperature_high_c

Suhu Hemat Energi Maksimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = eco.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c`
Hasil	`number` Contoh: 24,5
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

eco_temperature_low_f

Suhu Hemat Energi Minimum, yang ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat hvac_mode = eco.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f`
Hasil	`number` Contoh: 65
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

eco_temperature_low_c

Suhu Hemat Energi Minimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = eco.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c`
Hasil	`number` Misalnya: 19,5
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

perbarui_temperature_high_f (TIDAK DIGUNAKAN LAGI)

Suhu maksimum maksimum, yang ditampilkan dalam derajat derajat penuh (1°F).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f`
Hasil	`number` Contoh: 80
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

perbarui_temperature_high_c (TIDAK DIGUNAKAN LAGI)

Suhu pergi maksimum, ditampilkan dalam setengah derajat Celsius (0,5 °C).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c`
Hasil	`number` Contoh: 24,5
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

perbarui_temperature_low_f (TIDAK DIGUNAKAN LAGI)

Suhu minimum minimum, yang ditampilkan dalam derajat derajat penuh (1°F).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f`
Hasil	`number` Contoh: 65
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

perbarui_temperature_low_c (TIDAK DIGUNAKAN LAGI)

Suhu minimum minimum, ditampilkan dalam setengah derajat Celsius (0,5°C).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c`
Hasil	`number` Misalnya: 19,5
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

mode_hvac

Menunjukkan mode penghangat/penyejuk sistem HVAC, seperti Heat•Cool untuk sistem dengan kapasitas penghangat dan pendingin, atau Suhu Hemat Energi untuk penghematan energi.

hvac_mode dapat diubah jika Termostat dikunci
target_temperature_f dan target_temperature_c tidak dapat diubah jika hvac_mode = off atau eco

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode`
Hasil	`string enum` Nilai: "heat", "cool", "heat-cool", "eco", "off"
Akses	baca/tulis
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

suhu_sunyi_f

Suhu, diukur pada perangkat, dalam derajat derajat penuh (1°F).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f`
Hasil	`number` Contoh: 72
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

suhu_suhu_c

Suhu, diukur pada perangkat, dalam setengah derajat Celsius (0,5°C).

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c`
Hasil	`number` Contoh: 21,5
Akses	hanya baca
Tersedia di	Pembacaan termostat / v1-v6 Pembacaan/penulisan termostat / v1-v6

kelembapan

Kelembapan, dalam persen (%) format, yang diukur di perangkat, dibulatkan ke 5% terdekat.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/humidity`
Hasil	`number` Contoh: 35
Rentang	0-100
Akses	hanya baca
Tersedia di	Pembacaan termostat / v2-v6 Pembacaan/penulisan / pemutaran termostat v2-v6

hvac_state

Menunjukkan apakah sistem HVAC aktif menghangatkan, menyejukkan, atau nonaktif. Gunakan nilai ini untuk menunjukkan status aktivitas HVAC.

Saat off, sistem HVAC tidak menghangatkan atau menyejukkan secara aktif. hvac_state tidak bergantung pada operasi kipas.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/hvac_state`
Hasil	`string enum` Nilai: "pemanasan", "sejuk", "nonaktif"
Akses	hanya baca
Tersedia di	Termostat baca / v3-v6 Pembacaan/penulisan termostat / v3-v6

id_mana

ID unik yang dibuat Nest yang mewakili name, nama tampilan perangkat.

Pelajari lebih lanjut tempat nama untuk Nest Thermostat, Nest Protect, dan Nest Cam.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/where_id`
Hasil	`string` Contoh: "d6reb_OZTM..."
Akses	hanya baca
Tersedia di	Pembacaan termostat / v4-v6 Pembacaan/penulisan / pemerolehan v4-v6

_dikunci

Status Kunci Termostat. Jika benar, fitur Kunci Termostat akan diaktifkan, dan membatasi rentang suhu ke nilai minimum/maksimum ini: locked_temp_min_f, locked_temp_max_f, locked_temp_min_c, dan locked_temp_max_c.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/is_locked`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v5-v6 Pembacaan/penulisan termostat / v5-v6

smart_temp_min_f terkunci

Suhu minimum Kunci Termostat, yang ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat is_locked adalah true.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f`
Hasil	`string` Contoh: 65
Akses	hanya baca
Tersedia di	Pembacaan termostat / v5-v6 Pembacaan/penulisan termostat / v5-v6

terkunci_temp_max_f

Suhu maksimum Kunci Termostat, yang ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat is_locked adalah true.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f`
Hasil	`string` Contoh: 80
Akses	hanya baca
Tersedia di	Pembacaan termostat / v5-v6 Pembacaan/penulisan termostat / v5-v6

terkunci_temp_min_c

Suhu minimum Kunci Termostat, yang ditampilkan dalam suhu setengah derajat Celsius (0,5°C). Digunakan saat is_locked adalah true.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c`
Hasil	`string` Misalnya: 19,5
Akses	hanya baca
Tersedia di	Pembacaan termostat / v5-v6 Pembacaan/penulisan termostat / v5-v6

terkunci_temp_max_c

Suhu maksimum Kunci Termostat, ditampilkan dalam tampilan setengah setengah Celsius (0,5°C). Digunakan saat is_locked adalah true.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c`
Hasil	`string` Contoh: 24,5
Akses	hanya baca
Tersedia di	Pembacaan termostat / v5-v6 Pembacaan/penulisan termostat / v5-v6

label

Label kustom termostat. Muncul dalam tanda kurung, setelah nama tempat.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/label`
Hasil	`string` Contoh: "Ruang atas", "Ruang tamu", "Ruang bermain"
Akses	baca/tulis
Tersedia di	Baca: Termostat baca / v6 Baca/tulis Termostat / v6 Tulis: Baca/tulis Termostat / v5 -v6

sunlight_Koreksi_diaktifkan

Status Sunblock aktif. Digunakan dengan sunlight_correction_active. Saat true, teknologi Sunblock diaktifkan, dan Termostat otomatis menyesuaikan cahaya matahari langsung, dengan membaca dan menyetel suhu yang tepat.

Untuk mengetahui informasi selengkapnya, lihat Apa Sunblock?

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

sunlight_Koreksi_aktif

Status aktif pemblokiran matahari. Digunakan dengan sunlight_correction_enabled. Jika true, menunjukkan bahwa Termostat terletak di bawah sinar matahari langsung.

Untuk mengetahui informasi selengkapnya, lihat Apa Sunblock?

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active`
Hasil	`boolean` Nilai: benar (true), salah (false)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

dengan_nama

Nama tampilan perangkat. Ditautkan dengan Termostat where_id. Dapat berupa nama ruangan apa pun dari daftar yang kami berikan, atau nama kustom. Pelajari lebih lanjut tempat nama untuk Nest Thermostat, Nest Protect, dan Nest Cam.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/where_name`
Hasil	`string` Contoh: "Hallway"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

fan_time__duration

Menentukan durasi (dalam menit) saat kipas disetel untuk berjalan.

Setelan fan_timer_active akan mengaktifkan kipas. Nilai fan_timer_timeout menunjukkan stempel waktu saat fan_timer_duration ditetapkan ke akhir.

Untuk mempelajari cara pelanggan menyetel timer kipas, lihat Durasi Timer.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration`
Hasil	`int` Nilai: 15, 30, 45, 60, 120, 240, 480, 720
Akses	baca/tulis
Tersedia di	Baca: Termostat baca / v6 Baca/tulis Termostat / v6 Tulis: Baca/tulis Termostat / v6

waktu_untuk_target

Waktu, dalam menit, yang diperlukan sampai struktur mencapai suhu target.

Lihat Waktu ke Suhu untuk informasi selengkapnya.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/time_to_target`
Hasil	`string enum` Nilai: "~0", "<5", "~15", "~90", "120"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

waktu_untuk_target_pelatihan

Saat dalam mode pelatihan, Nest Thermostat mempelajari sistem HVAC dan menemukan waktu yang diperlukan untuk mencapai suhu target. Jika Termostat memiliki informasi yang cukup untuk membuat perkiraan waktu yang wajar untuk mencapai suhu target, nilai ini akan berubah dari training menjadi ready.

Lihat Waktu ke Suhu untuk informasi selengkapnya.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training`
Hasil	`string enum` Nilai: "pelatihan", "siap"
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat

mode_hvac_sebelumnya

Menampilkan hvac_mode yang dipilih terakhir. Digunakan saat beralih dari hvac_mode = eco di perangkat dengan firmware yang sudah tidak berlaku.

Untuk mempelajari lebih lanjut cara beralih antara mode Hemat Energi dan non-Eco, lihat Panduan Termostat.

Detail
`https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode`
Hasil	`string` Nilai: "heat", "cool", "heat-cool", "off", kosong (tidak ada nilai)
Akses	hanya baca
Tersedia di	Pembacaan termostat / v6 Pembacaan/penulisan / v6 termostat