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

על שירות הקן

יישומי Nest מאפשרים למשתמשים להתחבר לביתם מכל מקום שהוא נמצא. כל מכשירי Nest (תרמוסטטים, מגן ומצלמות) ויישומים (אפליקציות iOS, Android ואינטרנט) מתחברים לשירות Nest.

דוגמא לענן לענן

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

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

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

מודל הנתונים

ה- API של Nest מיוצג כמסמך JSON עם מאפיינים ברמה העליונה של metadata , devices structures . מוצרי ה- Works שלך עם Nest משתמשים במסמך JSON זה כדי לקיים אינטראקציה עם מכשירי Nest ושינויים במצב קשורים לתגובה עליהם, ולהגיב עליהם.

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

devices Nest מייצגים devices פיזיים (תרמוסטטים, מגן ומצלמות) בתוך מבנה.

ניתן להתייחס לכל רכיב נתונים במסמך JSON לפי URL (המכונה גם "מיקומי נתונים"). עבודות עם מוצרי Nest יכולות לקרוא ולכתוב לחלקים במסמך זה ולהירשם לשינויים. יכולת מנוי זו מאפשרת למוצרי Works עם Nest להגיב בזמן אמת לשינויים שבוצעו במערכת, כגון כיבוי אורות כאשר משתמש מכוון את המבנה ל- Away.

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

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

מדינה מיועדת

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

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

מודל פרסום / מנוי ממוקד מסמך זה מספק אינטראקציות יישומיות תגובה.

באמצעות שירות הקן

כדי לגשת לנקודות הקצה של REST בשירות Nest, השתמש ב- HTTPS במוצר שלך. ישנן ספריות לקוחות רבות של צד שלישי שיכולות לשמש למטרה זו.

אישורים והרשאות

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

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

הענקת אסימון גישה יוצרת יחסי אמון בין משתמש, מוצר Works with Nest ו- Nest. משתמשים יכולים לבטל את הגישה בכל עת.

כדי ללמוד כיצד לאשר חיבור ל- Nest API, עיין בסקירת ההרשאות .