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

The Architecture of the Nest API

درباره سرویس Nest

برنامه های Nest به کاربران این امکان را می دهد تا از هر کجا که باشند با خانه خود ارتباط برقرار کنند. همه دستگاه های Nest (ترموستات ، محافظت و دوربین) و برنامه ها (iOS ، Android و برنامه های وب) به سرویس Nest متصل می شوند.

مثال ابر به ابر

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

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

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

مدل داده

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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