גוגל מחויבת לקדם הון גזעי עבור קהילות שחורות. תראה איך.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

התייחסות ל- Nest API

ממשק API של Nest מדגם בית או בניין פיזי כמבנה, כאשר תרמוסטטים של Nest Learning, Nest Protects ו- Nest Cams הם מכשירים במבנה. מבנה זה מכיל גם מידע על הבית בכללותו (כגון מדינת Away או ETA, או שעות Rush פעילות).

ניתן לפנות לכל אלמנט נתונים במבנה באמצעות כתובת אתר של משאב (המכונה "מיקומי נתונים") במסמך JSON משותף. כל מיקום נתונים יכול לאחסן מחרוזות, מספרים, בולינאים, אובייקטים של הורה / ילד או מערכים.

חקור את מודל הנתונים בעזרת הפניה זו ל- API אינטראקטיבי .

ממשק ה- API אתה יכול לסנכרן נתונים ממיקומים ברמות מרובות במודל הנתונים, לדוגמה:

  • מבנה שלם, כולל כל המכשירים
  • מכשיר יחיד במבנה
  • קבוצה של ערכי נתונים (טמפרטורה נוכחית וסביבה)
  • ערך נתונים יחיד (מצב בריאות סוללה)

על המוצרים שלך להגיב מהורהר לאירועים כמו אלה:

עם זאת, זכור כי כל אחד מהאובייקטים מבוססי המכשיר פועל תחת מגבלות בעולם האמיתי. לדוגמה, התרמוסטט לא אמור להפעיל את המזגן כאשר מופעל חום חירום. ממשק ה- API שלנו נועד לשמור על המכשירים שלנו וגם על הבית של המשתמש, וימנע פעולות מסוימות אם הן היו מפתיעות או מסוכנות.

הרשאות ונתוני מכשירים משותפים

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

למידע נוסף ראה סקירת הרשאות .

נתונים ופרטיות

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

למידע נוסף על השקפותינו בנושא פרטיות .

מטא נתונים

מטא נתונים הם מידע נוסף המסופק כאשר אתה מתקשר לנקודת הסיום ברמת השורש:

https://developer-api.nest.com/

אסימון גישה

לאחר אישור משתמש, המוצר שלך משתמש באספקת גישה לביצוע שיחות API לשירות Nest. אסימון גישה זה משמש כהוכחה לכך שמשתמש אישר למוצר שלך לבצע שיחות בשמם.

פרטים
החזרות string
דוגמה: "c.FmDPkzyzaQe ..."

client_version

גרסת לקוח היא הגרסה האחרונה המורשית על ידי לקוח, access_token ל access_token .

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

פרטים
החזרות number
דוגמאות: 1, 17, 42

זהות המשתמש

זיהוי המשתמש מאפשר לך לזהות משתמשים בכל שיחות API. מזהה זה שונה לכל שילוב של מוצר עם Nest ומשתמש של משתמש.

לדוגמה, אם משתמש 1 אישר עבודות עם מוצר קן A ועובד עם מוצר קן B, למוצר A יש ערך user_id אחד למשתמש 1, ולמוצר B יש ערך user_id שונה למשתמש 1.

פרטים
החזרות string
דוגמה: z.1.1.7DHps ...