Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

ממשק API של תרמוסטט

ממשק API של Nest עובד עם כל דגמי Nest Learning Thermostat ™, למעט התרמוסטט E עם Heat Link באיחוד האירופי.

משתמשים יכולים להוסיף מספר תרמוסטטים של קן לקבוצת devices/thermostats , עד למקסימום לכל מבנה . כשאתה מתקשר למיקום נתונים זה, אתה יכול לגשת לנתוני Nest Thermostat (ערכי נתונים עבור התקנים במבנה).

כל הערכים שלהלן נמצאים תחת כל devices/thermostats/ device_id במסמך JSON.

device_id

מזהה ייחודי של קן תרמוסטט.

פרטים
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

חיבור אחרון

חותמת זמן של האינטראקציה האחרונה והמצליחה עם שירות Nest, בפורמט ISO 8601 .

פרטים
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

יכולת מערכת להתקרר (יש AC).

פרטים
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_using_emergency_heat

מצב חום בשעת חירום במערכות עם משאבות חום לקירור.

כאשר חום החירום פועל:

  • המשתמש יכול להתאים את טמפרטורת היעד במכשיר, אך אינו יכול לשנות את המצב עד לכיבוי חום החירום
  • עדיין ניתן לשנות את ה- hvac_mode דרך ה- API

ראה מהו חום חירום? לקבלת מידע נוסף על האופן בו תרמוסטט הקן תומך בחום חירום.

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
החזרות boolean
ערכים: נכון, שקר
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v1-v6
תרמוסטט קורא / כותב / v1-v6

יש_fan

יכולת מערכת לשלוט במאוורר באופן עצמאי מחימום או קירור.

פרטים
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 (זמן עצירה), בפורמט ISO 8601 .

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
החזרות string
דוגמה: "2016-12-31T23: 59: 59.000Z"
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v1-v6
תרמוסטט קורא / כותב / v1-v6

יש_עלף

מוצג כאשר התרמוסטט מוגדר לטמפרטורת חיסכון באנרגיה.

פרטים
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 ° F). משמש כאשר 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 ° F). משמש כאשר 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 ° F). משמש כאשר 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 ° F). משמש כאשר 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 ° F). משמש כאשר 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 (DEPRECATED)

טמפרטורת מרחק מקסימאלית, מוצגת בכל מעלות פרנהייט (1 ° F).

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
החזרות number
דוגמא: 80
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v1-v6
תרמוסטט קורא / כותב / v1-v6

away_temperature_high_c (DEPRECATED)

טמפרטורת מרחק מקסימאלית, מוצגת בחצי מעלות צלזיוס (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 (DEPRECATED)

טמפרטורת מרחק מינימלית, מוצגת בכל מעלות פרנהייט (1 ° F).

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
החזרות number
דוגמא: 65
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v1-v6
תרמוסטט קורא / כותב / v1-v6

away_temperature_low_c (DEPRECATED)

טמפרטורת מרחק מינימלית, מוצגת בחצי מעלות צלזיוס (0.5 מעלות צלזיוס).

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
החזרות number
דוגמא: 19.5
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v1-v6
תרמוסטט קורא / כותב / v1-v6

hvac_mode

מציין מצבי חימום / קירור של מערכת HVAC, כמו חום • מגניב למערכות בעלות יכולת חימום וקירור, או טמפרטורות אקו לחיסכון באנרגיה.

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
החזרות string enum
ערכים: "חום", "מגניב", "חום מגניב", "אקו", "כבוי"
גִישָׁה קרוא וכתוב
זמין ב קריאת תרמוסטט / 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 מחממת, מתקררת או מנותקת באופן פעיל. השתמש בערך זה כדי לציין מצב פעילות HVAC.

במצב off , מערכת HVAC אינה מחממת או מתקררת באופן פעיל. hvac_state אינו תלוי בפעולת המאוורר.

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
החזרות string enum
ערכים: "חימום", "קירור", "כבוי"
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v3-v6
תרמוסטט קורא / כותב / v3-v6

איפה

מזהה ייחודי שנוצר על ידי הקן המייצג את 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_min_f , locked_temp_max_f , locked_temp_min_c 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

נעול_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

נעול_טמפ_מקס_ף

טמפרטורת נעילה מקסימאלית של התרמוסטט , מוצגת בכל מעלות פרנהייט (1 מעלות צלזיוס). משמש כאשר is_locked נעול true .

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
החזרות string
דוגמא: 80
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v5-v6
תרמוסטט קורא / כותב / v5-v6

נעול_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

נעול_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

sunlight_correction_enabled

סטטוס מופעל באמצעות Sunblock. משמש עם sunlight_correction_active . כאשר true , טכנולוגיית Sunblock מופעלת, והתרמוסטט מסתגל אוטומטית לאור שמש ישיר, קורא ומגדיר את הטמפרטורה הנכונה.

למידע נוסף, ראה מה זה Sunblock?

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
החזרות boolean
ערכים: נכון, שקר
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v6
תרמוסטט קורא / כותב / v6

אור שמש

סטטוס פעיל של Sunblock. משמש עם sunlight_correction_enabled . כאשר true , מציין שהתרמוסטט ממוקם באור שמש ישיר.

למידע נוסף, ראה מה זה Sunblock?

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
החזרות boolean
ערכים: נכון, שקר
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v6
תרמוסטט קורא / כותב / v6

איפה

שם התצוגה של המכשיר. משויך לתרמוסטט 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 לומד על מערכת ה- 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 . משמש בעת מעבר מ- hvac_mode = eco במכשיר עם קושחה מיושנת.

למידע נוסף על החלפת מצבים של betwen Eco ו- non-Eco, עיין במדריך התרמוסטט .

פרטים
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
החזרות string
ערכים: "חום", "קר", "חום קר", "כבוי", ריק (ללא ערך)
גִישָׁה לקריאה בלבד
זמין ב קריאת תרמוסטט / v6
תרמוסטט קורא / כותב / v6