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 termostat

Nest API bekerja dengan semua model Nest Learning Thermostat ™, kecuali untuk Thermostat E dengan Heat Link di UE.

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

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

device_id

Nest Thermostat pengidentifikasi unik.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Kembali string
Contoh: "peyiJNo0IldT2YlIVtYaGQ"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

lokal

Menentukan preferensi bahasa dan wilayah (atau negara).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Kembali string
Contoh: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

versi perangkat lunak

Versi perangkat lunak.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Kembali string
Contoh: "4.0"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

structure_id

Struktur pengidentifikasi unik.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Kembali string
Contoh: "VqFabWH21nw ..."
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

nama

Tampilkan nama perangkat. Dapat berupa nama ruangan apa pun dari daftar yang kami sediakan, atau nama khusus.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /name
Kembali string
Contoh: "Lorong"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

name_long

Nama tampilan panjang perangkat. Termasuk custom (label), dibuat oleh pengguna, atau melalui wheres .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Kembali string
Contoh: "Hallway Thermostat (lantai atas)"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / 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
Kembali string
Contoh: "2016-12-31T23: 59: 59.000Z"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

sedang on line

Status koneksi perangkat dengan layanan Nest.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

can_cool

Kemampuan sistem untuk mendinginkan (memiliki AC).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

can_heat

Kemampuan sistem untuk memanaskan.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

is_using_emergency_heat

Status Panas Darurat dalam sistem dengan pompa panas untuk pendinginan.

Saat Panas Darurat aktif:

  • Pengguna dapat menyesuaikan suhu target pada perangkat, tetapi tidak dapat mengubah mode hingga Heat Emergency dimatikan
  • The hvac_mode masih dapat diubah melalui API

Lihat Apa Itu Panas Darurat? untuk informasi lebih lanjut tentang bagaimana Thermostat Nest mendukung Panas Darurat.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

has_fan

Kemampuan sistem untuk mengontrol kipas secara independen dari pemanasan atau pendinginan.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

fan_timer_active

Menunjukkan apakah timer kipas diaktifkan; digunakan dengan fan_timer_duration untuk menyalakan kipas selama durasi yang telah ditentukan (ditentukan pengguna).

Lihat Kontrol Kipas Tingkat Lanjut untuk informasi lebih lanjut tentang cara pelanggan mengatur durasi kipas.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Kembali boolean
Nilai: benar, salah
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

fan_timer_timeout

Cap waktu ditampilkan ketika penghitung waktu kipas mencapai 0 (waktu berhenti), dalam format ISO 8601 .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Kembali string
Contoh: "2016-12-31T23: 59: 59.000Z"
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

has_leaf

Ditampilkan ketika termostat diatur ke suhu hemat energi.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

skala suhu

Fahrenheit atau Celsius; digunakan dengan tampilan suhu.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Kembali string enum
Nilai: "F", "C"
Mengakses Baca tulis
Tersedia di Baca:
Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6
Menulis:
Thermostat baca / tulis / v5-v6

target_temperature_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
Kembali number
Contoh: 72
Jarak 50-90
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

target_temperature_c

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

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Kembali number
Contoh: 21.5
Jarak 9-32
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

target_temperature_high_f

Suhu target maksimum, ditampilkan dalam derajat Fahrenheit (1 ° F). Digunakan saat hvac_mode = heat-cool (mode Panas • Dingin).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Kembali number
Contoh: 80
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

target_temperature_high_c

Suhu target maksimum, ditampilkan dalam setengah derajat Celcius (0,5 ° C). Digunakan saat hvac_mode = heat-cool (mode Panas • Dingin).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Kembali number
Contoh: 24.5
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

target_temperature_low_f

Suhu target minimum, ditampilkan dalam derajat Fahrenheit (1 ° F). Digunakan saat hvac_mode = heat-cool (mode Panas • Dingin).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Kembali number
Contoh: 65
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

target_temperature_low_c

Suhu target minimum, ditampilkan dalam setengah derajat Celcius (0,5 ° C). Digunakan saat hvac_mode = heat-cool (mode Panas • Dingin).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Kembali number
Contoh: 19.5
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

eco_temperature_high_f

Suhu Eco Maksimum, ditampilkan dalam derajat Fahrenheit (1 ° F). Digunakan saat hvac_mode = eco .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Kembali number
Contoh: 80
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

eco_temperature_high_c

Suhu Eco Maksimum, ditampilkan dalam setengah derajat Celcius (0,5 ° C). Digunakan saat hvac_mode = eco .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Kembali number
Contoh: 24.5
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

eco_temperature_low_f

Minimum Eco Temperature, ditampilkan dalam derajat Fahrenheit (1 ° F). Digunakan saat hvac_mode = eco .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Kembali number
Contoh: 65
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

eco_temperature_low_c

Minimum Eco Temperature, ditampilkan dalam setengah derajat Celcius (0,5 ° C). Digunakan saat hvac_mode = eco .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Kembali number
Contoh: 19.5
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

away_temperature_high_f (DEPRECATED)

Temperatur pergi maksimum, ditampilkan dalam derajat Fahrenheit (1 ° F).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Kembali number
Contoh: 80
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

away_temperature_high_c (DEPRECATED)

Temperatur maksimum, ditampilkan dalam setengah derajat Celcius (0,5 ° C).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Kembali number
Contoh: 24.5
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

away_temperature_low_f (DEPRECATED)

Temperatur tandang minimum, ditampilkan dalam derajat penuh Fahrenheit (1 ° F).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Kembali number
Contoh: 65
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

away_temperature_low_c (DEPRECATED)

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

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Kembali number
Contoh: 19.5
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

hvac_mode

Mengindikasikan mode pemanasan / pendinginan sistem HVAC, seperti Panas • Dinginkan untuk sistem dengan kapasitas pemanasan dan pendinginan, atau Temperatur Ramah Lingkungan untuk penghematan energi.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Kembali string enum
Nilai: "panas", "dingin", "panas-dingin", "ramah lingkungan", "tidak aktif"
Mengakses Baca tulis
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

ambient_temperature_f

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

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Kembali number
Contoh: 72
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

ambient_temperature_c

Temperatur, diukur pada perangkat, dalam setengah derajat Celcius (0,5 ° C).

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Kembali number
Contoh: 21.5
Mengakses hanya baca
Tersedia di Thermostat baca / v1-v6
Thermostat baca / tulis / v1-v6

kelembaban

Kelembaban, dalam format persen (%), diukur pada perangkat, dibulatkan ke 5% terdekat.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Kembali number
Contoh: 35
Jarak 0-100
Mengakses hanya baca
Tersedia di Thermostat baca / v2-v6
Thermostat baca / tulis / v2-v6

hvac_state

Menunjukkan apakah sistem HVAC aktif memanaskan, mendinginkan, atau mati. Gunakan nilai ini untuk menunjukkan status aktivitas HVAC.

Saat off , sistem HVAC tidak secara aktif memanaskan atau mendinginkan. hvac_state tidak tergantung pada operasi kipas.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Kembali string enum
Nilai: "pemanasan", "pendinginan", "tidak aktif"
Mengakses hanya baca
Tersedia di Thermostat baca / v3-v6
Thermostat baca / tulis / v3-v6

where_id

Pengidentifikasi unik yang dibuat oleh Nest yang mewakili name , nama tampilan perangkat.

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

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Kembali string
Contoh: "d6reb_OZTM ..."
Mengakses hanya baca
Tersedia di Thermostat baca / v4-v6
Thermostat baca / tulis / v4-v6

terkunci

Status Kunci Thermostat. Ketika benar, fitur Kunci Thermostat diaktifkan, dan membatasi rentang suhu ke nilai min / maks 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
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v5-v6
Thermostat baca / tulis / v5-v6

terkunci_temp_min_f

Suhu Kunci Termostat Minimum, ditampilkan dalam derajat Fahrenheit (1 ° F). Digunakan ketika is_locked true .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Kembali string
Contoh: 65
Mengakses hanya baca
Tersedia di Thermostat baca / v5-v6
Thermostat baca / tulis / v5-v6

terkunci_temp_max_f

Suhu Kunci Thermostat Maksimum, ditampilkan dalam derajat Fahrenheit (1 ° F). Digunakan ketika is_locked true .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Kembali string
Contoh: 80
Mengakses hanya baca
Tersedia di Thermostat baca / v5-v6
Thermostat baca / tulis / v5-v6

terkunci_temp_min_c

Suhu Kunci Termostat Minimum, ditampilkan dalam ditampilkan dalam setengah derajat Celcius (0,5 ° C). Digunakan ketika is_locked true .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Kembali string
Contoh: 19.5
Mengakses hanya baca
Tersedia di Thermostat baca / v5-v6
Thermostat baca / tulis / v5-v6

terkunci_temp_max_c

Suhu Kunci Thermostat Maksimum, ditampilkan dalam ditampilkan dalam setengah derajat Celcius (0,5 ° C). Digunakan ketika is_locked true .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Kembali string
Contoh: 24.5
Mengakses hanya baca
Tersedia di Thermostat baca / v5-v6
Thermostat baca / tulis / v5-v6

label

Label khusus termostat. Muncul di tanda kurung, setelah nama tempat.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /label
Kembali string
Contoh: "Lantai Atas", "Ruang tamu", "Ruang Bermain"
Mengakses Baca tulis
Tersedia di Baca:
Thermostat baca / v6
Thermostat baca / tulis / v6
Menulis:
Thermostat baca / tulis / v5-v6

sunlight_correction_enabled

Status Sunblock diaktifkan. Digunakan dengan sunlight_correction_active . Ketika true , teknologi Sunblock diaktifkan, dan Thermostat secara otomatis menyesuaikan ke sinar matahari langsung, membaca dan mengatur suhu yang benar.

Untuk info lebih lanjut, lihat Apa itu Sunblock?

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

sunlight_correction_active

Status aktif Sunblock. Digunakan dengan sunlight_correction_enabled . Bila true , tunjukkan bahwa Thermostat terletak di bawah sinar matahari langsung.

Untuk info lebih lanjut, lihat Apa itu Sunblock?

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

where_name

Nama tampilan perangkat. Terkait dengan Thermostat where_id . Dapat berupa nama ruangan apa pun dari daftar yang kami sediakan, atau nama khusus. Pelajari lebih lanjut tentang di mana nama untuk Termostat Sarang , Perlindungan Sarang , dan Sarang Cams .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Kembali string
Contoh: "Lorong"
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

fan_timer_duration

Menentukan lama waktu (dalam menit) yang diatur kipas untuk dijalankan.

Pengaturan fan_timer_active mengaktifkan kipas. Nilai fan_timer_timeout menunjukkan cap waktu ketika fan_timer_duration diatur ke akhir.

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

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Kembali int
Nilai: 15, 30, 45, 60, 120, 240, 480, 720
Mengakses Baca tulis
Tersedia di Baca:
Thermostat baca / v6
Thermostat baca / tulis / v6
Menulis:
Thermostat baca / tulis / v6

time_to_target

Waktu, dalam beberapa menit, yang diperlukan struktur untuk mencapai suhu target.

Lihat Waktu-ke-Suhu untuk informasi lebih lanjut.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Kembali string enum
Nilai: "~ 0", "<5", "~ 15", "~ 90", "120"
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

time_to_target_training

Saat berada dalam mode pelatihan, Nest Thermostat mempelajari tentang sistem HVAC dan menemukan berapa banyak waktu yang diperlukan untuk mencapai suhu target. Ketika Thermostat 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 lebih lanjut.

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Kembali string enum
Nilai: "pelatihan", "siap"
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6

metode_mode sebelumnya

Menampilkan hvac_mode terakhir dipilih. Digunakan saat beralih dari hvac_mode = eco pada perangkat dengan firmware yang ketinggalan jaman.

Untuk mempelajari lebih lanjut tentang beralih antara mode Eco dan non-Eco, lihat Panduan Thermostat .

Detail
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Kembali string
Nilai: "panas", "dingin", "panas-dingin", "mati", kosong (tidak ada nilai)
Mengakses hanya baca
Tersedia di Thermostat baca / v6
Thermostat baca / tulis / v6