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 של Nest מספק גישה לנתונים ברמת המבנה הבאים, תלוי ברמת ההרשאות שניתנות:

  • שם המבנה והמכשיר "איפה שם" (מיקום בבית)
  • רשימת המכשירים בבית
  • מצב אירוע אנרגיה ( שעת העומס באנרגיה )
  • מדינה רחוקה
  • משתמש ETA
  • מדינת ביטחון
  • מיקוד או מיקוד

חלק מהתכונות ברמת המבנה מכוסות במדריכי API נפרדים ומפורטים יותר:

הרשאות מבנה

לגישה ל ... בחר...
רוב ערכי הנתונים structures מתנגדים הרחק , ETA , אנרגיה , או מיקוד הרשאות
ערך נתוני name באובייקט structures מבנה הרשאת קריאה / כתיבה

ראה כיצד ההרשאות עובדות ב- Reference API האינטראקטיבי .

מזהי מבנה

שֵׁם

שם המבנה כברירת מחדל הוא "בית" אך יכול להיות כל מחרוזת שהמשתמש יבחר. כשאתה בוחר הרשאת קריאה / כתיבה של מבנה , אתה יכול לשנות את name המבנה.

איפה

wheres הוא אובייקט שנקבע במבנה, המכיל איפה מזהים ( where_id name ). השתמש wheres כדי ליצור שמות מותאמים אישית בהם, או לגשת לסטנדרטים שבהם שמות.

גישת wheres האובייקט דורשת מצלמה , עשן + CO מעורר , או טרמוסטט הרשאות.

where_id

  • מזהה ייחודי שנוצר על ידי הקן המייצג את name
  • where_id הוא לקריאה בלבד, והוא נוצר אוטומטית את השיחה כדי ליצור מנהג שבו name

name

  • שם התצוגה של המכשיר; יכול להיות כל שם חדר מרשימה שאנו מספקים, או שם מותאם אישית
  • כדי ליצור מנהג שבו name , לבצע שיחת POST כדי לכתוב מנהג חדש, שבו name ; where_id בשיחה
  • שיקולים
    • לא ניתן לערוך או למחוק את name לאחר היצירה
    • name חייב להיות ייחודי בתוך המבנה
    • אם התקן משויך למבנה, המנהג בו נגיש name המשויך למכשיר מהנתיב /structures/ נתיב
    • כדי להעביר את התקן עם מנהג שבו name למבנה שונה, לבטל התאמה למכשיר, ולאחר מכן צמד מחדש את המכשיר עם השם רצוי

למידע נוסף על שמות עבור תרמוסטטים של קן , מגן על קנים ומצלמות קן .

מטא נתונים אחרים

כל ערכי הנתונים נקראים בלבד, אלא אם כן צוין אחרת.

ערך נתונים תיאור
structure_id מחרוזת המייצגת באופן ייחודי את המבנה הזה. כל מפתח יראה מזהה שונה לאותו מבנה, אך מספר מוצרים מאותו מפתח יראו את אותו המזהה
country_code קוד מדינה ISO 3166-1 alpha-2 הממפה למיקום הרשום של המבנה
postal_code מיקוד או מיקוד, תלוי במדינה
time_zone מחרוזת אזור זמן של IANA הממפה לאזור הזמן של המבנה

מאפייני מבנה

מצבי אזעקת עשן ו CO

כשאתה בוחר הרשאת קריאה ב- Smoke + CO , אתה יכול לגשת ל- smoke_alarm_state ו- co_alarm_state באובייקט structures . אותם ערכי נתונים אלה זמינים גם באובייקט המכשיר ( devices/smoke_co_alarms ).

עיין במדריך אזעקת Smoke + CO לקבלת מידע נוסף על מצבים אלה.

ערכי נתונים רבים עובדים יחד כדי לקבוע כיצד מכשירים מתנהגים במבנה.

  • כאשר מבנה away מדינה מוגדרת away את המילה "ECO" מוצגת על קן טרמוסטט, בשפה המועדפת של המשתמש
  • כאשר מבנה away מדינה מוגדרת away , תוכל:
    • הגדר fan_timer_active
    • שינוי target_temperature_f target_temperature_c או target_temperature_c
  • כשמצב away מבנה מוגדר home , אתה יכול:
    • בצע שיחת ETA (הגדר מזהה נסיעה וחלון הגעה)
  • כאשר כיבוי חירום פעיל, אינך יכול להגדיר fan_timer_active
  • כאשר חום חירום מופעל, אינך יכול להגדיר את המבנה למצב away

מבנים מרובים

יתכן שלמשתמש מחוברים יותר ממבנה אחד לחשבון הקן שלו, ולכן המוצר שלך צריך להציע אמצעי למשתמש לבחור מבין המבנים הזמינים (בוחר מבנה).

בורר מבנה

לדוגמה, בעת הגדרת ETA, חשוב שהמשתמש יוכל לבחור מבנה עבור היעד ETA. באופן דומה, יכול למשתמש להיות שני גלאי עשן ב"סלון "של שני בתים שונים. אם אתה צריך לבצע מתאם מבנה עם מושג הבית שלך, אנו ממליצים לך לעשות זאת במהלך תהליך ההרשאה.

למד כיצד משתמשים מנהלים מכשירים במבנים מרובים .

מקסימום מכשירים

יש גבולות לכמה מכשירים שקן תומך במבנה.

סוג מכשיר מקסימום למבנה
תרמוסטט קן 20
מצלמות קן 10
קן הגן 18

הודעות שגיאה

למידע על המשמעות של שגיאות קריאת API וכיצד לטפל בהן, עיין בהודעות שגיאה .