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 متصل می شوند.

به عنوان مثال ابر به ابر

سرویس Nest یک مدل داده از خانه را ارائه می دهد. دستگاه ها و برنامه های کاربردی از این مدل داده خوانده شده تا اقدامات مناسب را انجام دهند. آنها مدل داده را به روز می کنند تا منعکس کننده تغییرات در سیستم باشد.

به عنوان مثال ، یک ترموستات دمای مورد نظر خود را از مدل داده می خواند. این دمای محیط را به اندازه گیری فعلی خود تنظیم می کند ، و داده های حسگر را به Home / Away Assist ارسال می کند ، که براساس آن حالت ساختار را تنظیم می کند.

دستگاه های لانه در محیط های محدود کار می کنند. برق محدود است و اتصال به شبکه خانگی قابل اطمینان نیست. محصولات و خدمات شما می توانند با استفاده از الگوریتم های دستگاه ما ، یک تجربه خانه ساده و شهودی را به کاربران ارائه دهند.

مدل داده

Nest API به عنوان یک سند JSON با ویژگی های سطح metadata العاده metadata ، devices و structures . کارهای شما با محصولات Nest از این سند JSON برای تعامل و واکنش به دستگاههای Nest و تغییرات حالت مربوط استفاده می کند.

structures آشیانه نمایانگر structures بدنی در دنیای واقعی هستند. آنها به عنوان یک مکان سازماندهی برای devices و ذخیره داده برای ساختمان به عنوان یک کل هستند. به طور معمول ، یک structure خانه کاربر است.

devices آشیانه devices فیزیکی (ترموستات ، محافظت و دوربین) را در یک ساختار نشان می دهند.

هر عنصر داده موجود در سند JSON توسط URL قابل آدرس است (همچنین به عنوان "مکان داده" شناخته می شود). کار با محصولات Nest می تواند بخش هایی از این سند را بخواند و بنویسد و مشترکاً در تغییرات باشد. این قابلیت اشتراک به کارگران با محصولات Nest امکان می دهد تا در زمان واقعی نسبت به تغییرات ایجاد شده در سیستم واکنش نشان دهند ، مانند خاموش کردن چراغ ها در هنگام تنظیم ساختار کاربر از Away.

اشیاء نیز تحت محدودیت های دنیای واقعی کار می کنند. مدل داده با جلوگیری از اقدامات غافلگیرکننده و خطرناک ، از دستگاه ها و خانه کاربر محافظت می کند. به عنوان مثال ، ترموستات با فعال کردن گرمای اضطراری ، تهویه هوا را اجرا نمی کند.

مدل داده را با این مرجع API تعاملی کاوش کنید.

حالت در نظر گرفته شده

خدمات Nest وضعیت معتبر سیستم را ذخیره می کند و محصولات با Nest کار می کند مشترکاً در تغییرات ایجاد می شود. تغییر این حالت (به عنوان مثال ، تغییر دمای هدف ترموستات) باعث می شود تا این سرویس یک اعلان تغییر را برای همه مشترکان اعمال کند.

از آنجا که این انتشار تاخیر دارد و شبکه ها قابل اعتماد نیستند ، ممکن است حالت مشاهده شده توسط یک محصول ، دولتی باشد که در حال حاضر توسط سایر محصولات یا خدمات مشاهده می شود. با انتقال پیام ها بین محصولات مختلف ، حالت در نهایت هماهنگ می شود.

این مدل انتشار / اشتراک مدار محور ، تعامل برنامه پاسخگو را فراهم می کند.

با استفاده از سرویس Nest

برای دسترسی به نقاط انتهایی REST در سرویس Nest ، از HTTPS در محصول خود استفاده کنید. بسیاری از کتابخانه های شخص ثالث وجود دارد که می توانند برای این منظور استفاده شوند.

مجوزها و مجوزها

ما می خواهیم به توسعه دهندگان اجازه دهیم محصولات و خدماتی را ایجاد کنند که خانه ها را بهتر کند بدون اینکه به خطر بیفتد حریم شخصی و امنیت کاربر است. همه ارتباطات ما ایمن است و اجازه دسترسی به داده ها همیشه صریحاً توسط کاربر اعطا می شود. برای اطلاعات بیشتر ، به مروری بر مجوزها مراجعه کنید.

مجوز توسط پروتکل OAuth 2.0 انجام می شود. هنگامی که کاربر موافقت می کند دسترسی به سطح اجازه درخواست شده را فراهم کند ، Nest درخواست را تأیید می کند و یک نشانه دسترسی به درخواست کننده اعطا می شود. از این نشانه دسترسی می توان برای دسترسی به Nest API و تعامل با ساختار و دستگاه های کاربر استفاده کرد.

اعطای نشانه دسترسی ، یک رابطه اعتماد بین کاربر ، کار با محصول Nest و Nest را برقرار می کند. کاربران می توانند دسترسی را در هر زمان لغو کنند.

برای یادگیری نحوه مجاز سازی ارتباط با API Nest ، به مروری بر مجوز مراجعه کنید.