Google is committed to advancing racial equity for Black communities. See how.

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

تعمل Nest API مع جميع طرز Nest Learning Thermostat ™ ، باستثناء Thermostat E مع Heat Link في الاتحاد الأوروبي.

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

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

معرف الجهاز

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

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

اللغة

يحدد تفضيل اللغة والمنطقة (أو الدولة).

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

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

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

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

معرف الهيكل

المعرف الفريد للهيكل.

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

اسم

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

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

اسم_لونج

اسم العرض الطويل للجهاز. يتضمن مخصصة (التسمية)، التي تم إنشاؤها من قبل المستخدم، أو عن طريق wheres .

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
عائدات string
مثال: "ترموستات المدخل (الطابق العلوي)"
وصول يقرأ فقط
متوفر في قراءة الترموستات / v1-v6
قراءة / كتابة ترموستات / v1-v6

اتصال_الأخير

الطابع الزمني للتفاعل الناجح الماضي مع خدمة عش، في 8601 ISO الشكل.

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

متصل

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

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

can_cool

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

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

يمكن_تسخين

قدرة النظام على التسخين.

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

is_used_em Emergency_heat

حالة الحرارة الطارئة في الأنظمة ذات المضخات الحرارية للتبريد.

عند تشغيل حرارة الطوارئ:

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

ترى ما الحرارة في حالات الطوارئ؟ لمزيد من المعلومات حول كيفية دعم Nest Thermostat للتدفئة في حالات الطوارئ.

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

حسن

قدرة النظام على التحكم في المروحة بشكل مستقل عن التسخين أو التبريد.

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

fan_timer_active

يشير إلى ما إذا كان مؤقت المروحة يعمل ؛ استخدامها مع fan_timer_duration لتشغيل مروحة ل(المحددة من قبل المستخدم) مدة محددة مسبقا.

نرى فان مراقبة متقدمة لمزيد من المعلومات حول كيفية إعداد عملاء مدة مروحة.

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

fan_timer_timeout

الطابع الزمني تظهر عندما يصل الموقت مروحة 0 (وقف الوقت)، في 8601 ISO الشكل.

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

has_leaf

يُعرض عند ضبط منظم الحرارة على درجة حرارة موفرة للطاقة.

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

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

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

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

target_temperature_f

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

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

target_temperature_c

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

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

target_temperature_high_f

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

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
عائدات number
مثال: 80
وصول قراءة و كتابة
متوفر في قراءة الترموستات / v1-v6
قراءة / كتابة ترموستات / v1-v6

target_temperature_high_c

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

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
عائدات number
مثال: 24.5
وصول قراءة و كتابة
متوفر في قراءة الترموستات / v1-v6
قراءة / كتابة ترموستات / v1-v6

target_temperature_low_f

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

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
عائدات number
مثال: 65
وصول قراءة و كتابة
متوفر في قراءة الترموستات / v1-v6
قراءة / كتابة ترموستات / v1-v6

target_temperature_low_c

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

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
عائدات number
مثال: 19.5
وصول قراءة و كتابة
متوفر في قراءة الترموستات / v1-v6
قراءة / كتابة ترموستات / v1-v6

eco_temperature_high_f

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

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

eco_temperature_high_c

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

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

eco_temperature_low_f

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

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

eco_temperature_low_c

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

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

away_temperature_high_f (موقوف)

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

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

away_temperature_high_c (موقوف)

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

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

away_temperature_low_f (موقوف)

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

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

away_temperature_low_c (موقوف)

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

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

hvac_mode

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

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
عائدات string enum
القيم: "heat" ، "cool" ، "heat-cool" ، "eco" ، "off"
وصول قراءة و كتابة
متوفر في قراءة الترموستات / v1-v6
قراءة / كتابة ترموستات / v1-v6

ambient_temperature_f

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

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

ambient_temperature_c

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

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

رطوبة

الرطوبة ، بالنسبة المئوية (٪) ، المقاسة بالجهاز ، مقربة إلى أقرب 5٪.

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
عائدات number
مثال: 35
نطاق 0-100
وصول يقرأ فقط
متوفر في قراءة الترموستات / v2-v6
قراءة / كتابة ترموستات / v2-v6

hvac_state

يشير إلى ما إذا كان نظام التدفئة والتهوية وتكييف الهواء (HVAC) يقوم بالتدفئة أو التبريد أو إيقاف التشغيل. استخدم هذه القيمة للإشارة إلى حالة نشاط التدفئة والتهوية وتكييف الهواء.

عندما off ، ونظام HVAC لا تسخين بنشاط أو التبريد. hvac_state مستقلة عن تشغيل مروحة.

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
عائدات string enum
القيم: "تسخين" ، "تبريد" ، "إيقاف"
وصول يقرأ فقط
متوفر في قراءة الترموستات / v3-v6
قراءة / كتابة ترموستات / v3-v6

where_id

فريد، معرف ولدت عش التي تمثل name ، اسم العرض للجهاز.

تعلم المزيد عن أسماء حيث الحرارة عش ،عش يحمي و عش الحدب .

تفاصيل
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
عائدات string
مثال: "d6reb_OZTM ..."
وصول يقرأ فقط
متوفر في قراءة ترموستات / v4-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
القيم: صحيح ، خطأ
وصول يقرأ فقط
متوفر في قراءة ترموستات / v5-v6
قراءة / كتابة ترموستات / v5-v6

locked_temp_min_f

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

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

مقفول_ emp_max_f

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

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

locked_temp_min_c

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

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

locked_temp_max_c

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

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

ضع الكلمة المناسبة

الحرارة تسمية مخصصة . يظهر بين قوسين بعد اسم أين.

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

تم تمكين تصحيح_ضوء الشمس

تم تمكين وضع Sunblock. استخدامها مع sunlight_correction_active . عندما true ، يتم تمكين التكنولوجيا ريحلات، والحرارة وضبط تلقائيا لأشعة الشمس المباشرة، والقراءة، ووضع درجة الحرارة الصحيحة.

لمزيد من المعلومات، راجع ما هو ريحلات؟

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

أشعة الشمس_تصحيح_نشط

حالة Sunblock نشطة. استخدامها مع sunlight_correction_enabled . عندما true ، يشير إلى أن الحرارة يقع في أشعة الشمس المباشرة.

لمزيد من المعلومات، راجع ما هو ريحلات؟

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

where_name

اسم عرض الجهاز. المرتبطة الحرارة where_id . يمكن أن يكون أي اسم غرفة من قائمة نقدمها ، أو اسمًا مخصصًا. تعلم المزيد عن أسماء حيث الحرارة عش ،عش يحمي و عش الحدب .

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

fan_timer_duration

يحدد المدة الزمنية (بالدقائق) التي تم ضبط المروحة على العمل فيها.

و 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
وصول قراءة و كتابة
متوفر في يقرأ:
قراءة الترموستات / v6
قراءة / كتابة / v6 ترموستات
كتابة:
قراءة / كتابة / v6 ترموستات

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

الوقت ، بالدقائق ، الذي سيستغرقه الهيكل للوصول إلى درجة الحرارة المستهدفة.

نرى في الوقت لدرجة الحرارة لمزيد من المعلومات.

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

time_to_target_training

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

نرى في الوقت لدرجة الحرارة لمزيد من المعلومات.

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

الوضع_hvac_mode السابق

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

لمعرفة المزيد حول تبديل بين العامين بيئة وسائط غير للبيئة، راجع دليل الحرارة .

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