Termostat API'si

Nest API, AB'de Isı Bağlantılı Termostat E hariç, tüm Nest Learning ThermostatTM modelleriyle çalışır.

Kullanıcılar, yapı başına maksimum değer olacak şekilde, devices/thermostats grubuna birden fazla Nest Termostatı ekleyebilir. Bu veri konumunu aradığınızda, Nest Thermostat verilerine (yapıdaki cihazların veri değerleri) erişebilirsiniz.

Aşağıdaki tüm değerler JSON dokümanındaki her bir devices/thermostats/device_id altında bulunur.

cihaz_kimliği

Nest Thermostat benzersiz tanımlayıcısı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/device_id
İadelerstring
Örnek: "peyiJNo0IldT2YlIVtYaGQ"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

locale

Dil ve bölge (veya ülke) tercihini belirtir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/locale
İadelerstring
Örnekler: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

yazılım_sürümü

Yazılım sürümü.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/software_version
İadelerstring
Örnek: "4,0"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

yapı_kimliği

Benzersiz tanımlayıcı yapılandırın.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
İadelerstring
Örnek: "VqFabWH21nw..."
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

ad

Cihazın görünen adı. Sağladığımız listedeki herhangi bir oda adı veya özel bir ad olabilir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/name
İadelerstring
Örnek: "Hadway"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

ad_uzun

Cihazın uzun görünen adı. Kullanıcı tarafından veya wheres aracılığıyla oluşturulan bir özel (etiket) içerir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/name_long
İadelerstring
Örnek: "Holway Thermostat (yukarıda)"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

son_bağlantı

Nest hizmetiyle son başarılı etkileşimin, ISO 8601 biçimindeki zaman damgası.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/last_connection
İadelerstring
Örnek: "2016-12-31T23:59:59.000Z"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

çevrimiçi

Nest hizmetiyle cihaz bağlantı durumu.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/is_online
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

can_cool

Sistemin soğuma özelliği (AC).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/can_cool
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

teneke_ısı

Sistemin ısıtma kapasitesi.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/can_heat
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

acil durum_ısı_kullanma

Isıtma pompalı sistemlerde soğutma için Acil Isıtma durumu.

Acil Durum Isıtması açıkken:

  • Kullanıcı cihazdaki hedef sıcaklığı ayarlayabilir, ancak Acil Isıtma kapatılana kadar modu değiştiremez
  • hvac_mode hâlâ API aracılığıyla değiştirilebilir

Nest Thermostat'ın Acil Durum Isıtmasını nasıl desteklediği hakkında daha fazla bilgi için Acil Durum Nedir? konusuna bakın.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

has_fan

Fanın ısıtma veya soğutmadan bağımsız olarak kontrol edilmesini sağlayan sistem.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/has_fan
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

fan_timer_active etkin

Fan zamanlayıcının devrede olup olmadığını gösterir; fanı (kullanıcı tarafından belirtilen) önceden ayarlanmış bir süre boyunca açmak için fan_timer_duration ile kullanılır.

Müşterilerin fan süresini nasıl ayarladığı hakkında daha fazla bilgi için Gelişmiş Hayran Kontrolü bölümüne bakın.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
İadelerboolean
Değerler: true, false
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

fan_timer_timeout

Fan zamanlayıcının 0'a (durma süresi) ne zaman ulaştığını ISO 8601 biçiminde gösteren zaman damgası.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout
İadelerstring
Örnek: "2016-12-31T23:59:59.000Z"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

has_leaf

Termostat enerji tasarrufu yapan sıcaklığa ayarlandığında gösterilir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

sıcaklık_ölçek

Fahrenhayt veya Santigrat; sıcaklık göstergesiyle kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale
İadelerstring enum
Değerler: "F", "C"
Erişimokuma/yazma
Kullanıma sunulduğu dillerOkuma:
Termostat okuma / v1-v6
Termostat okuma/yazma / v1-v6
Yazma:
Termostat okuma/yazma / v5-v6

hedef_sıcaklık_f

Tam olarak Fahrenhayt derece (1°F) olarak istenen sıcaklık. hvac_mode = heat veya cool olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f
İadelernumber
Örnek: 72
Aralık50-90
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

hedef_sıcaklık_c

Yarım santigrat derece (0, 5 °C) istenen sıcaklık. hvac_mode = heat veya cool olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c
İadelernumber
Örnek: 21,5
Aralık9-32
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

hedef_sıcaklık_yüksek_f

Tam hedef Fahrenhayt derece (1°F) olarak gösterilen maksimum hedef sıcaklık. hvac_mode = heat-cool olduğunda kullanılır (Sıcaklık Soğuk mod).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f
İadelernumber
Örnek: 80
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

hedef_sıcaklık_yüksek_c

Yarım santigrat derece (0, 5°C) olarak gösterilen maksimum hedef sıcaklık. hvac_mode = heat-cool olduğunda (Sıcaklık Mod modu) kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c
İadelernumber
Örnek: 24,5
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

hedef_sıcaklık_düşük_f

Tam hedef Fahrenhayt derece (1°F) olarak gösterilen minimum hedef sıcaklık. hvac_mode = heat-cool olduğunda kullanılır (Sıcaklık Soğuk mod).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f
İadelernumber
Örnek: 65
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

hedef_sıcaklık_düşük_c

Yarım santigrat derece (0, 5°C) olarak gösterilen minimum hedef sıcaklık. hvac_mode = heat-cool olduğunda (Sıcaklık Mod modu) kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c
İadelernumber
Örnek: 19,5
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

eko_sıcaklık_yüksek_f

Maksimum Eko Sıcaklık (fahrenhayt derece (1°F) olarak görüntülenir). hvac_mode = eco olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
İadelernumber
Örnek: 80
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

eko_sıcaklık_yüksek_c

Maksimum Eko Sıcaklık, yarım santigrat derece (0,5°C) cinsinden görüntülenir. hvac_mode = eco olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
İadelernumber
Örnek: 24,5
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

eko_sıcaklık_düşük_f

Tam Eko Sıcaklık (fahrenhayt derece (1°F) olarak görüntülenir). hvac_mode = eco olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
İadelernumber
Örnek: 65
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

eko_sıcaklık_düşük_c

Yarım Santigrat (0, 5°C) cinsinden gösterilen Minimum Eko Sıcaklık. hvac_mode = eco olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c
İadelernumber
Örnek: 19,5
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

dışarıda_sıcaklık_yüksek_f (KULLANIMDAN KALDIRILDI)

Maksimum uzaklık sıcaklığı (fahrenhayt (1°F) olarak görüntülenir).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f
İadelernumber
Örnek: 80
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

dışarıda_sıcaklık_yüksek_c (KULLANIMDAN KALDIRILDI)

Yarım santigrat derece (0, 5°C) cinsinden gösterilen maksimum uzaklık sıcaklığı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c
İadelernumber
Örnek: 24,5
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

dışarıda_sıcak_düşük_f (KULLANIMDAN KALDIRILDI)

Tam olarak Fahrenhayt (1°F) derece olarak gösterilen minimum dışarıda sıcaklığı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f
İadelernumber
Örnek: 65
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

dışarıda_sıcak_düşük_c (KULLANIMDAN KALDIRILDI)

Yarım santigrat derece (0, 5°C) olarak görüntülenen minimum uzaklık sıcaklığı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
İadelernumber
Örnek: 19,5
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

hvac_mode

Isıtma ve soğutma kapasitesi olan sistemler için Isıtma, Soğutma veya enerji tasarrufu için Eko Sıcaklıklar gibi HVAC sisteminin ısıtma/soğutma modlarını belirtir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
İadelerstring enum
Değerler: "ısıtma", "soğutma", "ısıtma-soğutma", "eco", "kapalı"
Erişimokuma/yazma
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

ortam_ısısı_f

Cihaz Fahrenhayt (1°F) derece olarak ölçülen sıcaklık.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
İadelernumber
Örnek: 72
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

ortam_ısısı_c

Cihazda yarım Santigrat (0,5°C) cinsinden ölçülen sıcaklık.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c
İadelernumber
Örnek: 21,5
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v1-v6
Termostat okuma/yazma / v1-v6

nem

Cihazda ölçülen, yüzde (%) biçimindeki nem oranı, en yakın %5'e yuvarlanır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/humidity
İadelernumber
Örnek: 35
Aralık0-100
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v2-v6
Termostat okuma/yazma / v2-v6

hvac_durumu

HVAC sisteminin etkin şekilde ısındığını, soğutulduğunu veya kapalı olduğunu belirtir. HVAC etkinlik durumunu belirtmek için bu değeri kullanın.

off olduğunda Isıtma, Havalandırma ve Soğutma sistemi aktif olarak ısınmıyor veya soğutma yapmıyor. hvac_state, fan işleminden bağımsızdır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state
İadelerstring enum
Değerler: "ısıtma", "soğutma", "kapalı"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v3-v6
Termostat okuma/yazma / v3-v6

nerede_kimliği

Nest'in oluşturduğu, cihazın görünen adını name temsil eden benzersiz bir tanımlayıcı.

Nest Thermostat, Nest Protects ve Nest Cams için adlar hakkında daha fazla bilgi edinin.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/where_id
İadelerstring
Örnek: "d6reb_OZTM..."
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v4-v6
Termostat okuma/yazma / v4-v6

kilitli

Termostat Kilidi durumu. Doğru değerine ayarlandığında Termostat Kilidi özelliği etkinleştirilir ve sıcaklık aralığını bu minimum/maks. değerlerle sınırlar: locked_temp_min_f, locked_temp_max_f, locked_temp_min_c ve locked_temp_max_c.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/is_locked
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v5-v6
Termostat okuma/yazma / v5-v6

kilitli_temp_min_f

MinimumTermostat Kilit tam sıcaklık (1°F) olarak görüntülenen sıcaklık. is_locked, true olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f
İadelerstring
Örnek: 65
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v5-v6
Termostat okuma/yazma / v5-v6

kilitli_temp_f_f

MaksimumTermostat Kilit tam sıcaklık (1°F) olarak görüntülenen sıcaklık. is_locked, true olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
İadelerstring
Örnek: 80
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v5-v6
Termostat okuma/yazma / v5-v6

kilitli_temp_min_c

Minimum Termostat Kilit sıcaklığı, yarım santigrat derece (0,5°C) olarak gösterilir. is_locked true olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
İadelerstring
Örnek: 19,5
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v5-v6
Termostat okuma/yazma / v5-v6

kilitli_temp_maks

Maksimum Termostat Kilitleme sıcaklığı, yarım santigrat derece (0,5°C) cinsinden gösterilir. is_locked true olduğunda kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
İadelerstring
Örnek: 24,5
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v5-v6
Termostat okuma/yazma / v5-v6

etiket

Termostat özel etiketi. Yer adından sonra parantez içinde görünür.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/label
İadelerstring
Örnekler: "Üst katlar", "Konuk odası", "Oyun odası"
Erişimokuma/yazma
Kullanıma sunulduğu dillerOkuma:
Termostat okuma / v6
Termostat okuma/yazma / v6
Yazma:
Termostat okuma/yazma / v5 -s6

gün ışığı_düzeltme_etkin

Güneşi Önleme etkin durumu. sunlight_correction_active ile kullanılır. true olduğunda, Güneş Kremi teknolojisi etkin olur ve Termostat doğrudan güneş ışığına göre otomatik olarak ayarlanarak, doğru sıcaklığı okuyup ayarlar.

Daha fazla bilgi için Güneş engelleme nedir?

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

gün ışığı_düzeltme_etkin

Güneş kremi etkin durumu. sunlight_correction_enabled ile kullanılır. true olduğunda, Termostatın doğrudan güneş ışığında olduğunu belirtir.

Daha fazla bilgi için Güneş engelleme nedir?

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

nerede_adı

Cihazın görünen adı. Termostatla ilişkilendirilmiştir where_id. Sağladığımız listedeki herhangi bir oda adı veya özel bir ad olabilir. Nest Thermostat, Nest Protects ve Nest Cams için adlar hakkında daha fazla bilgi edinin.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/where_name
İadelerstring
Örnek: "Hadway"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

Fan_timer_duration

Fanın ayarlı olduğu süreyi (dakika cinsinden) belirtir.

Fanı etkinleştiren fan_timer_active ayarı. fan_timer_timeout değeri, fan_timer_duration son olarak ayarlandığında zaman damgasını belirtir.

Müşterilerin fan zamanlayıcıyı nasıl ayarladığını öğrenmek için Zamanlayıcı Süresi'ne bakın.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration
İadelerint
Değerler: 15, 30, 45, 60, 120, 240, 480, 720
Erişimokuma/yazma
Kullanıma sunulduğu dillerOkuma:
Termostat okuma / v6
Termostat okuma/yazma / v6
Yazma:
Termostat okuma/yazma / v6

hedefe_hedef_zaman

Yapının hedef sıcaklığa ulaşması için gereken süre (dakika cinsinden).

Daha fazla bilgi için Sıcaklık Süresi konusuna bakın.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target
İadelerstring enum
Değerler: "~0", "<5", "~15", "~90", "120"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

hedef_hedef_hedef_zaman

Eğitim modundayken Nest Thermostat, HVAC sistemi hakkında bilgi edinir ve hedef sıcaklığa ulaşmak için ne kadar süre kaldığını öğrenir. Termostat, hedef sıcaklığa ulaşmak için gereken süreyi makul bir şekilde tahmin etmeye yetecek kadar bilgiye sahip olduğunda bu değer training değerinden ready değerine değişir.

Daha fazla bilgi için Sıcaklık Süresi konusuna bakın.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
İadelerstring enum
Değerler: "training", "Ready"
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6

önceki_hvac_mode

Son seçilen hvac_mode gösterilir. Donanım yazılımı eski olan bir cihazda hvac_mode = eco ayarından geçiş yaparken kullanılır.

Eko mod ve Eko olmayan modlar arasında geçiş yapma hakkında daha fazla bilgi için Termostat Kılavuzu'na bakın.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
İadelerstring
Değerler: "ısıtma", "soğutma", "ısıtma-soğutma", "kapalı", boş (değer yok)
Erişimsalt okunur
Kullanıma sunulduğu dillerTermostat okuma / v6
Termostat okuma/yazma / v6