واجهة برمجة تطبيقات ترموستات

تعمل Nest API مع جميع طُرز Nest LearningTMTM ، باستثناء الترموستات هـ مع وضع "التدفئة" في الاتحاد الأوروبي.

يمكن للمستخدمين إضافة أجهزة Nest Thermostat متعددة إلى مجموعة devices/thermostats، ما يصل إلى الحد الأقصى لكل بنية. عند إجراء مكالمة إلى موقع البيانات هذا، يمكنك الوصول إلى بيانات Nest Thermostat (قيم البيانات للأجهزة في البنية).

تم العثور على جميع القيم أدناه أسفل كل devices/thermostats/device_id في مستند JSON.

معرّف_الجهاز

المعرّف الفريد لـ Nest Thermostat

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/device_id
طلبات الإرجاعstring
مثال: "peyiJNo0IldT2YlIVtYaGQ"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

locale

يحدّد هذا الخيار اللغة والمنطقة المفضّلَين (أو البلد).

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/locale
طلبات الإرجاعstring
أمثلة: "en-GB"، "en-US"، "es-US"، "fr-CA"، "fr-CA"، "nl-NL"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

إصدار البرنامج

إصدار البرنامج.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/software_version
طلبات الإرجاعstring
مثال: "4.0"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

تركيبة_المعرّف

بنية المعرّف الفريد.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
طلبات الإرجاعstring
مثال: "VqFabWH21nw..."
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

اسم

الاسم المعروض للجهاز يمكن أن يكون أي اسم غرفة من قائمة نوفّرها أو اسم مخصّص.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/name
طلبات الإرجاعstring
مثال: "المدخل"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

الاسم_طويل

الاسم المعروض الطويل للجهاز وتتضمن تصنيفًا مخصّصًا (أنشأه المستخدم) أو من خلال wheres.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/name_long
طلبات الإرجاعstring
مثال: "ال ترموستات في الردهة (في الطابق العلوي)"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

آخر اتصال

الطابع الزمني لآخر تفاعل ناجح مع خدمة Nest، بتنسيق ISO 8601.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/last_connection
طلبات الإرجاعstring
مثال: "2016-12-31T23:59:59.000Z"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

على الإنترنت

حالة اتصال الجهاز مع خدمة Nest.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/is_online
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

cannot translate

قدرة النظام على التبريد (تحتوي على مكيّف هواء)

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/can_cool
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

cannot translate

قدرة النظام على التدفئة.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/can_heat
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

استخدام_حالة_الطوارئ_

حالة التدفئة الطارئة في الأنظمة التي تحتوي على مضخات حرارية للتبريد

عندما تكون "خاصية التدفئة الطارئة" مفعّلة:

  • يمكن للمستخدم ضبط درجة الحرارة المُثلى على الجهاز، ولكن لا يمكنه تغيير الوضع إلى أن يتم إيقاف ميزة "التدفئة الطارئة".
  • لا يزال بإمكانك تغيير hvac_mode من خلال واجهة برمجة التطبيقات

اطّلِع على قسم "ما هي حالة الطوارئ ؟

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

CANNOT TRANSLATE

قدرة النظام على التحكّم بشكل منفصل في نظام التدفئة أو التبريد

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/has_fan
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

مُسَاعِدْ نَشَاطْ

يشير إلى ما إذا كان موقّت المروحة مفعّلاً. يُستخدَم مع fan_timer_duration لتفعيل المروحة لمدة زمنية محددة (بتحديد المستخدم).

يمكنك الاطّلاع على قسم التحكّم المتقدّم في المعجبين للحصول على مزيد من المعلومات حول كيفية تحديد العملاء لمدة المروحة.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

الوقت_الأساسي_للمعجبين

الطابع الزمني الذي يعرض وقت وصول موقِّت المروحة إلى 0 (وقت التوقّف)، بتنسيق ISO 8601

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout
طلبات الإرجاعstring
مثال: "2016-12-31T23:59:59.000Z"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

لديها_ورقة شجر

يتم عرض هذا الإعداد عند ضبط الترموستات على درجة حرارة موفِّرة للطاقة.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

مقياس_درجة الحرارة

فهرنهايت أو درجة مئوية؛ المستخدم مع شاشة عرض درجة الحرارة.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale
طلبات الإرجاعstring enum
القيم: "F" و"C"
الوصولقراءة/كتابة
متوفّر فيقراءة:
قراءة الترموستات / الإصدار 1-v6
الترموستات للقراءة/الكتابة v1-v6
الكتابة:
قراءة الترموستات /كتابة / v5-v6

target_ أغاني_f

درجة الحرارة المطلوبة بالدرجات الكاملة فهرنهايت (1 درجة فهرنهايت) تُستخدَم هذه الخاصية عندhvac_mode = heat أو cool.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f
طلبات الإرجاعnumber
مثال: 72
النطاق50-90
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

target_efficiency_c (درجة_الطاقة_المستهدفة)

درجة الحرارة المطلوبة هي بنصف درجة مئوية (0.5 درجة مئوية) تُستخدَم هذه الخاصية عندhvac_mode = heat أو cool.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c
طلبات الإرجاعnumber
مثال: 21.5
النطاق9-32
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

target_ أغاني_عالية

الحد الأقصى لدرجة الحرارة المستهدفة، يتم عرضه بالدرجة الكاملة فهرنهايت (1 درجة فهرنهايت). يُستخدَم عندما يكون الوضع hvac_mode = heat-cool (درجة حرارة •وضع التبريد)

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f
طلبات الإرجاعnumber
مثال: 80
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

target_ أغاني_عالية

الحد الأقصى لدرجة الحرارة المستهدفة، يتم عرضه بنصف درجة مئوية (0.5 درجة مئوية). يُستخدَم عندما يكون الوضع hvac_mode = heat-cool (وضع التدفئة) رائع.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c
طلبات الإرجاعnumber
مثال: 24.5
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

target_efficiency_low (الحدّ_الأقصى_الأدنى)

الحد الأدنى لدرجة الحرارة المستهدَفة، معروض بالدرجات الكاملة فهرنهايت (1 درجة فهرنهايت). يُستخدَم عندما يكون الوضع hvac_mode = heat-cool (درجة حرارة •وضع التبريد)

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f
طلبات الإرجاعnumber
مثال: 65
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

target_ منتجع صحي

الحد الأدنى لدرجة الحرارة المستهدَفة، يتم عرضه بنصف درجة مئوية (0.5 درجة مئوية). يُستخدَم عندما يكون الوضع hvac_mode = heat-cool (وضع التدفئة) رائع.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c
طلبات الإرجاعnumber
مثال: 19.5
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

درجات الحرارة الاقتصادية

الحد الأقصى لدرجة الحرارة الاقتصادية، معروض بدرجات كاملة فهرنهايت (1 درجة فهرنهايت) يُستخدم عندما يكون hvac_mode = eco.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
طلبات الإرجاعnumber
مثال: 80
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

درجات حرارة اقتصادية_مرتفعة_c

الحد الأقصى لدرجة الحرارة الاقتصادية، يتم عرضه بنصف درجة مئوية (0.5 درجة مئوية). يُستخدم عندما يكون hvac_mode = eco.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
طلبات الإرجاعnumber
مثال: 24.5
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

درجات حرارة اقتصادية_منخفضة

الحد الأدنى لدرجة الحرارة الاقتصادية، معروض بدرجات كاملة فهرنهايت (1 درجة فهرنهايت) يُستخدم عندما يكون hvac_mode = eco.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
طلبات الإرجاعnumber
مثال: 65
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

درجات حرارة اقتصادية_منخفضة

الحد الأدنى لدرجة الحرارة الاقتصادية، يتم عرضه بنصف درجة مئوية (0.5 درجة مئوية). يُستخدم عندما يكون hvac_mode = eco.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c
طلبات الإرجاعnumber
مثال: 19.5
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

فضلاً عن درجة الحرارة_المرتفعة_(متوقف)

الحد الأقصى لدرجة الحرارة، يتم عرضه بدرجات فهرنهايت كاملة (1 درجة فهرنهايت).

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f
طلبات الإرجاعnumber
مثال: 80
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

الباقة_المرتفعة_مرتفعة_متوقفة (متوقف)

الحد الأقصى لدرجة الحرارة بعيدًا، يتم عرضه بنصف درجة مئوية (0.5 درجة مئوية).

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c
طلبات الإرجاعnumber
مثال: 24.5
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

out_efficiency_low_f (متوقف)

الحد الأدنى لدرجة الحرارة بعيدًا، ويتم عرضه بدرجات كاملة فهرنهايت (1 درجة فهرنهايت)

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f
طلبات الإرجاعnumber
مثال: 65
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

البَرَدْ لِوَصَفَةِ الْحَرَارَةْ مُنْخَفِضَةْ

الحد الأدنى لدرجة الحرارة بعيدًا، يتم عرضه بنصف درجة مئوية (0.5 درجة مئوية).

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
طلبات الإرجاعnumber
مثال: 19.5
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

وضع hvac_mode

تشير هذه الخاصية إلى أوضاع التدفئة/التبريد في نظام التدفئة والتهوية وتكييف الهواء، مثل نظام التدفئة •التبريد لأنظمة التدفئة والتبريد أو درجات الحرارة الاقتصادية لتوفير الطاقة.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
طلبات الإرجاعstring enum
القيم: "التدفئة"، "التبريد"، "التبريد الحر"، "درجات حرارة اقتصادية"، "إيقاف التشغيل"
الوصولقراءة/كتابة
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

درجة الحرارة_المناسبة

درجة الحرارة، تُقاس على الجهاز بالدرجة الكاملة فهرنهايت (1 درجة فهرنهايت).

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
طلبات الإرجاعnumber
مثال: 72
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

درجة حرارة_c_c

درجة الحرارة، تُقاس على الجهاز بنصف درجة مئوية (0.5 درجة مئوية)

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c
طلبات الإرجاعnumber
مثال: 21.5
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 1-v6
الترموستات قراءة/كتابة / v1-v6

الرُّطُوبَة

الرطوبة بالنسبة المئوية (وفقًا للنسبة المئوية) ويتم قياسها على الجهاز، مقرَّبةً إلى أقرب 5%.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/humidity
طلبات الإرجاعnumber
مثال: 35
النطاق0-‏100
الوصولللقراءة فقط
متوفّر فيجهاز قراءة الترموستات / الإصدار 2-v6
الترموستات/قراءة / v2-v6

التدفئة والتهوية وتكييف الهواء

تشير هذه الخاصية إلى ما إذا كان نظام التدفئة والتهوية وتكييف الهواء مفعّلاً أو باردًا أو متوقّفًا. يمكنك استخدام هذه القيمة للإشارة إلى حالة نشاط التدفئة والتهوية وتكييف الهواء.

عندما يكون نظام التدفئة والتهوية وتكييف الهواء off غير مستخدَم بشكل فعَّال. لا يرتبط hvac_state بميزة التشغيل في المروحة.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state
طلبات الإرجاعstring enum
القيم: "التدفئة"، "التبريد"، "إيقاف"
الوصولللقراءة فقط
متوفّر فيجهاز قراءة حرارة / الإصدار 3 - الإصدار 6
الترموستات قراءة/كتابة / v3-v6

أين_id

معرّف فريد يتم إنشاؤه من خلال Nest، وهو يمثل name، وهو الاسم المعروض للجهاز

تعرَّف على مزيد من المعلومات عن أماكن أسماء Nest Thermostat وNest Protect وNest Cam.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/where_id
طلبات الإرجاعstring
مثال: "d6reb_OZTM "
الوصولللقراءة فقط
متوفّر فيجهاز قراءة الترموستات / الإصدار 4-v6
الترموستات قراءة/كتابة / v4-v6

مقفل

حالة قفل الترموستات عند ضبط هذه السياسة على "صحيح"، يتم تفعيل ميزة الترموستات، وبذلك يتم حصر نطاق درجة الحرارة على القيم الدنيا/القصوى: locked_temp_min_f، locked_temp_max_f، locked_temp_min_c و locked_temp_max_c.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/is_locked
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيالترموستات للقراءة / الإصدار 5-v6
الترموستات/القراءة / الكتابة v5-v6

Lock_temp_min_f

الحد الأدنى لدرجة حرارة الترموستات هو الحرارة، ويتم عرضه بدرجات فهرنهايت كاملة (1 درجة فهرنهايت). يُستخدم عندما يكون is_locked true.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f
طلبات الإرجاعstring
مثال: 65
الوصولللقراءة فقط
متوفّر فيالترموستات للقراءة / الإصدار 5-v6
الترموستات/القراءة / الكتابة v5-v6

lock_temp_max_f

الحد الأقصى لدرجة الحرارة الترموستات: يتم عرضه بدرجات فهرنهايت كاملة (1 درجة فهرنهايت). يُستخدم عندما يكون is_locked true.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
طلبات الإرجاعstring
مثال: 80
الوصولللقراءة فقط
متوفّر فيالترموستات للقراءة / الإصدار 5-v6
الترموستات/القراءة / الكتابة v5-v6

مقفلة

يتم عرض درجة الحرارة الدنيا لدرجة الحرارة في الترموستات بتنسيق نصف درجة مئوية (0.5 درجة مئوية). يُستخدم عند is_locked true.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
طلبات الإرجاعstring
مثال: 19.5
الوصولللقراءة فقط
متوفّر فيالترموستات للقراءة / الإصدار 5-v6
الترموستات/القراءة / الكتابة v5-v6

lock_temp_max_c

الحد الأقصى لدرجة حرارة الترموستات، يتم عرضه بنصف درجة مئوية (0.5 درجة مئوية). يُستخدم عند is_locked true.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
طلبات الإرجاعstring
مثال: 24.5
الوصولللقراءة فقط
متوفّر فيالترموستات للقراءة / الإصدار 5-v6
الترموستات/القراءة / الكتابة v5-v6

label

ترموستات التصنيف المخصّص. يظهر بين قوسين، بعد اسم المكان.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/label
طلبات الإرجاعstring
أمثلة: "الطابق العلوي" و"غرفة الضيوف" و"غرفة اللعب"
الوصولقراءة/كتابة
متوفّر فيالقراءة:
قراءة الترموستات / الإصدار 6
من الترموستات للقراءة/الكتابة v6
الكتابة:
قراءة الترموستات أو كتابتها / v5 الإصدار 6

sunlight_تصحيح_تمكين

الحالة "مفعّلة" يُستخدَم مع sunlight_correction_active. عندما true، يتم تفعيل تقنية Sunblock، ويتم ضبط الترموستات تلقائيًا لأشعة الشمس المباشرة وقراءة وقراءة درجة الحرارة الصحيحة.

لمزيد من المعلومات، يمكنك الاطّلاع على ما معنى الشمس؟

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

sunlight_تصحيح_نشط

الحالة "منع" نشطة. يُستخدَم مع sunlight_correction_enabled. يشير true إلى أنّ الترموستات يقع في ضوء الشمس المباشر.

لمزيد من المعلومات، يمكنك الاطّلاع على ما معنى الشمس؟

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
طلبات الإرجاعboolean
القيم: صواب، خطأ
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

أين_الاسم

الاسم المعروض للجهاز. مرتبطة بالترموستات where_id. يمكن أن تكون أي اسم غرفة من قائمة نقدّمها، أو اسمًا مخصّصًا. تعرَّف على مزيد من المعلومات عن أماكن أسماء Nest Thermostat وNest Protect وNest Cam.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/where_name
طلبات الإرجاعstring
مثال: "المدخل"
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

مُدَّةُ الْمَرَّةْ

تحدّد المدة الزمنية (بالدقائق) التي يتم فيها إعداد المروحة لتشغيلها.

يؤدي إعداد fan_timer_active إلى تشغيل المروحة. تشير قيمة fan_timer_timeout إلى الطابع الزمني عند ضبط fan_timer_duration على النهاية.

لمعرفة كيفية ضبط العملاء لموقّت المروحة، يُرجى الاطّلاع على مدة الموقّت.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration
طلبات الإرجاعint
القيم: 15 و30 و45 و60 و120 و240 و480 و720
الوصولقراءة/كتابة
متوفّر فيالقراءة:
قراءة الترموستات / الإصدار 6
من الترموستات للقراءة/الكتابة v6
الكتابة:
القراءة/الكتابة / الإصدار 6 من الترموستات

الوقت_المستهدف_

الوقت بالدقائق، سيستغرق وصول البنية إلى درجة الحرارة المُثلى.

يمكنك الاطّلاع على درجة الحرارة إلى درجة الحرارة للحصول على مزيد من المعلومات.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target
طلبات الإرجاعstring enum
القيم: "~0"، "<5"، "~15"، "~90"، "120"
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

الوقت_المراد_تدريبه

في وضع التدريب، يتعرف Nest Thermostat على معلومات عن نظام التدفئة والتهوية وتكييف الهواء، ويكتشف الوقت الذي يستغرقه الوصول إلى درجة الحرارة المُثلى. عندما تتوفّر في جهاز الترموستات المعلومات الكافية لتقدير الوقت بشكل مناسب للوصول إلى درجة الحرارة المُثلى، ستتغيّر هذه القيمة من training إلى ready.

يمكنك الاطّلاع على درجة الحرارة إلى درجة الحرارة للحصول على مزيد من المعلومات.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
طلبات الإرجاعstring enum
القيم: "تدريب"، "جاهز"
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6

وضع_Hvac_السابق

عرض آخر عناصر تم اختيارها hvac_mode. يُستخدَم عند التبديل من hvac_mode = eco على جهاز يتضمن برامج ثابتة قديمة.

لمزيد من المعلومات عن التبديل بين وضعَي "درجات حرارة اقتصادية" و"درجات حرارة اقتصادية"، يمكنك الاطّلاع على دليل الترموستات.

التفاصيل
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
طلبات الإرجاعstring
القيم: "التدفئة"، "التبريد"، "التدفئة، التبريد"، "إيقاف"، فارغة (بدون قيمة)
الوصولللقراءة فقط
متوفّر فيترموستات قراءة / الإصدار 6
الترموستات قراءة/كتابة / الإصدار 6