
ساختارهای آشیانه نشان دهنده ساختارهای فیزیکی در دنیای واقعی هستند. معمولاً خانه کاربر، آنها به عنوان یک نقطه سازماندهی برای دستگاه ها عمل می کنند و داده هایی را ذخیره می کنند که برای کل خانه اعمال می شود.
Nest API بسته به سطح مجوزهای داده شده، دسترسی به دادههای سطح ساختار زیر را فراهم میکند:
- نام ساختار و دستگاه "where name" (مکان در خانه)
- لیست دستگاه های موجود در خانه
- وضعیت رویداد انرژی ( ساعت شلوغی انرژی )
- حالت دور
- ETA کاربر
- حالت امنیتی
- کد پستی یا پستی
برخی از ویژگیهای سطح ساختار در راهنمای API جداگانه و دقیقتری پوشش داده شدهاند:
- Away & ETA — حالت دور، کاربر ETA
- انرژی - وضعیت رویداد انرژی
- امنیت - امنیت و بازدارندگی
مجوزهای ساختار
برای دسترسی به ... | انتخاب کنید... |
---|---|
بیشتر مقادیر داده در structures شیء هستند | مجوزهای Away ، ETA ، Energy ، یا کد پستی |
مقدار داده name در شی structures | اجازه خواندن/نوشتن ساختار |
نحوه عملکرد مجوزها در مرجع API تعاملی را ببینید.
شناسه های ساختار
نام
نام ساختار پیشفرض روی «Home» است، اما میتواند هر رشتهای باشد که کاربر انتخاب میکند. وقتی مجوز خواندن/نوشتن ساختار را انتخاب میکنید، میتوانید name
ساختار را تغییر دهید.
کجاها
wheres
یک شی مجموعه روی یک ساختار است که حاوی شناسههای Where ( where_id
و name
) است. از wheres
یا دسترسی به نام های استاندارد Where استفاده کنید.
دسترسی به جسم wheres
به مجوزهای دوربین ، زنگ دود+CO یا ترموستات نیاز دارد.
where_id
- یک شناسه منحصربهفرد ایجاد شده توسط Nest که نشاندهنده
name
-
where_id
فقط خواندنی است و به طور خودکار در تماس ایجاد میشود تا یک مکان سفارشی ایجادname
name
- نام نمایشی دستگاه؛ میتواند هر نام اتاقی از فهرستی که ارائه میکنیم، یا نام سفارشی باشد
- برای ایجاد یک
name
جا سفارشی، یک فراخوانی POST برای نوشتن یکname
سفارشی Where انجام دهید.where_id
در تماس برگردانده می شود - ملاحظات
-
name
را نمی توان پس از ایجاد ویرایش یا حذف کرد -
name
باید در ساختار منحصر به فرد باشد - اگر دستگاهی با یک ساختار جفت شده باشد،
name
سفارشی مرتبط با دستگاه از مسیر/structures/
قابل دسترسی است. - برای انتقال یک دستگاه با یک
name
سفارشی به ساختاری دیگر، دستگاه را لغو جفت کنید و سپس دستگاه را با نام دلخواه دوباره جفت کنید.
-
درباره نامهای Nest Thermostats ، Nest Protects و Nest Cams بیشتر بیاموزید.
سایر ابرداده ها
همه مقادیر داده فقط خواندنی هستند، مگر اینکه خلاف آن مشخص شده باشد.
ارزش داده | شرح |
---|---|
structure_id | رشته ای که به طور منحصر به فرد این ساختار را نشان می دهد. هر توسعهدهندهای یک شناسه متفاوت برای یک ساختار میبیند، اما چندین محصول از یک توسعهدهنده همان شناسه را خواهند دید |
country_code | یک کد کشور ISO 3166-1 آلفا-2 که به مکان ثبت شده سازه نقشه میدهد |
postal_code | کد پستی یا پستی بسته به کشور |
time_zone | یک رشته منطقه زمانی IANA که به منطقه زمانی سازه نگاشت می شود |
ویژگی های ساختار
هشدار دود و CO
وقتی مجوز خواندن Smoke+CO را انتخاب میکنید، میتوانید به smoke_alarm_state
و co_alarm_state
در شی structures
دسترسی داشته باشید. همین مقادیر داده در شیء دستگاه نیز موجود است ( devices/smoke_co_alarms
).
برای اطلاعات بیشتر در مورد این حالت ها راهنمای هشدار دود + CO را ببینید.
محدودیت های مرتبط با ساختار
بسیاری از مقادیر داده با هم کار می کنند تا نحوه عملکرد دستگاه ها در یک ساختار را تعیین کنند.
- هنگامی که یک حالت
away
away
می شود، کلمه "ECO" در Nest Thermostat به زبان دلخواه کاربر نمایش داده می شود. - هنگامی که یک حالت دور از ساختار روی
away
تنظیم میaway
، می توانید:-
fan_timer_active
را تنظیم کنید -
target_temperature_f
یاtarget_temperature_c
را تغییر دهید
-
- وقتی یک حالت
away
ساختار رویhome
تنظیم می شود، می توانید:- برقراری تماس ETA (تنظیم شناسه سفر و پنجره ورود)
- وقتی خاموشی اضطراری فعال است، نمیتوانید
fan_timer_active
را تنظیم کنید - وقتی گرمای اضطراری فعال است، نمیتوانید ساختار را روی
away
تنظیم کنید
ساختارهای متعدد
ممکن است یک کاربر بیش از یک ساختار متصل به حساب Nest خود داشته باشد، بنابراین محصول شما باید ابزاری را برای کاربر ارائه دهد تا از بین ساختارهای موجود انتخاب کند (یک انتخابگر ساختار).

به عنوان مثال، هنگام تنظیم ETA، مهم است که کاربر بتواند ساختاری را برای مقصد ETA انتخاب کند. به روشی مشابه، یک کاربر می تواند دو آشکارساز دود در "اتاق نشیمن" دو خانه متفاوت داشته باشد. اگر نیاز به ارتباط ساختار با مفهوم خانه خود دارید، توصیه می کنیم این کار را در طول فرآیند مجوز انجام دهید.
بیاموزید که کاربران چگونه دستگاه ها را در چندین ساختار مدیریت می کنند .
حداکثر دستگاه
محدودیتهایی برای تعداد دستگاههایی که Nest در یک ساختار پشتیبانی میکند وجود دارد.
نوع وسیله | حداکثر در هر ساختار |
---|---|
Nest Thermostat | 20 |
دوربین های Nest | 10 |
Nest Protect | 18 |
پیغام خطا
برای اطلاعات در مورد اینکه خطاهای فراخوانی API به چه معنا هستند و نحوه رسیدگی به آنها، به پیام های خطا مراجعه کنید.