ساختار

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

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

نام ساختار و دستگاه "جایی که نام" (مکان در خانه)
لیست دستگاه های موجود در خانه
وضعیت رویداد انرژی ( ساعت عجله انرژی )
حالت دور
کاربر ETA
وضعیت امنیتی
کد پستی یا پستی

برخی از ویژگی های سطح ساختار در راهنماهای API جداگانه و دقیق تر پوشیده شده است:

Away & ETA - در حال حاضر ، کاربر ETA
انرژی - وضعیت رویداد انرژی
امنیت - امنیت و بازدارندگی

مجوز ساختار

برای دسترسی به ...	انتخاب کنید...
بیشتر مقادیر داده در `structures`	مجوزهای Away ، ETA ، Energy یا کد پستی
مقدار داده `name` در `structures`	مجوز خواندن / نوشتن ساختار

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

شناسه سازه

نام

نام ساختار پیش فرض "Home" است اما می تواند هر رشته ای باشد که کاربر انتخاب کند. هنگامی که ساختار خواندن و نوشتن ساختار را انتخاب می کنید ، می توانید name ساختار name تغییر دهید.

وایر

wheres شیئی است که بر روی یک ساختار تنظیم شده است و شامل شناسه هایی است که در آن ( where_id و name و name ) قرار دارد. از wheres برای ایجاد سفارشی در جایی که نام ها یا دسترسی به استاندارد در جایی که نام ها استفاده کنید استفاده کنید.

دسترسی به جسم wheres به مجوز دوربین ، دود + CO یا ترموستات نیاز دارد .

`where_id`

شناسه منحصر به فرد و تولید شده توسط لانه که نشان دهنده name
where_id فقط خواندنی است ، و به طور خودکار در تماس ایجاد می شود تا سفارشی در آن name

`name`

نام صفحه نمایش دستگاه؛ می تواند از لیستهایی که ارائه می دهیم یا نامی دلخواه برای هر اتاق باشد
برای ایجاد یک سفارشی که در آن name ، یک پیام POST بنویسید تا یک name جدید و خاص در جایی بنویسید. where_id در تماس برگشت داده می شود
ملاحظات
- name را نمی توان بعد از ایجاد ویرایش یا حذف کرد
- name باید در ساختار منحصر به فرد باشد
- اگر دستگاه با یک سازه زوج شده باشد ، سفارشی که در آن name مربوط به دستگاه از /structures/ مسیر قابل دسترسی باشد
- برای جابجایی دستگاه با سفارشی که در آن name به ساختار دیگری وجود دارد ، دستگاه را خاموش کنید و سپس دستگاه را با نام دلخواه مجدداً جفت کنید

در مورد نام های ترستسترهای Nest ، Nest Protects و Nest Cams اطلاعات بیشتری کسب کنید.

ابرداده دیگر

تمام مقادیر داده فقط خوانده می شوند ، مگر اینکه مواردی دیگر تعریف شده باشد.

مقدار داده	شرح
`structure_id`	رشته ای که منحصر به فرد نمایانگر این ساختار است. هر توسعه دهنده شناسه متفاوتی را برای همان ساختار مشاهده می کند ، اما چندین محصول از یک توسعه دهنده مشابه ، همان شناسه را مشاهده می کنند
`country_code`	کد کشور ISO 3166-1 alpha-2 که به محل ثبت شده سازه نقشه می کند
`postal_code`	بسته کد یا پستی ، بسته به کشور
`time_zone`	رشته زمانی IANA که به منطقه زمانی سازه نقشه می کند

ویژگی های ساختار

دزدگیر و حالت هشدار CO

هنگامی که شما انتخاب دود + CO عنوان خوانده شده اجازه ، شما می توانید دسترسی داشته باشید smoke_alarm_state و co_alarm_state در structures شی. همین مقادیر داده نیز در شیء دستگاه ( devices/smoke_co_alarms ) موجود است.

برای اطلاعات بیشتر در مورد این حالتها ، به راهنمای هشدار Smoke + CO مراجعه کنید.

محدودیت های مربوط به ساختار

بسیاری از مقادیر داده با هم کار می کنند تا نحوه عملکرد دستگاهها در یک ساختار را تعیین کنند.

هنگامی که یک ساختار away ساختمان قرار away کلمه "ECO" را روی ترموستات Nest (لانه ترموستات) نمایش دهد ، به زبان مورد نظر کاربر
هنگامی که یک وضعیت away ساختار away away ، می توانید:
- fan_timer_active تنظیم fan_timer_active
- تغییر target_temperature_f یا target_temperature_c
هنگامی که یک ساختمان away home ، می توانید:
- برقراری تماس ETA (شناسه سفر و پنجره ورود) را تنظیم کنید
هنگامی که اورژانس Shutoff فعال است ، نمی توانید fan_timer_active تنظیم fan_timer_active
هنگامی که اورژانس حرارتی فعال است ، نمی توانید ساختار را away

چندین ساختار

این امکان وجود دارد که کاربر بیش از یک ساختار متصل به حساب Nest خود را داشته باشد ، بنابراین محصول شما باید وسیله ای را برای انتخاب کاربر از ساختارهای موجود (انتخاب سازه) ارائه دهد.

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

بیاموزید که چگونه کاربران دستگاهها را در چندین ساختار مدیریت می کنند .

حداکثر دستگاه

محدودیت هایی در مورد تعداد دستگاه های Nest در یک ساختار وجود دارد.

نوع وسیله	حداکثر در هر ساختار
ترموستات آشیانه	20
دوربین های لانه	10
آشیانه محافظت کنید	18

پیغام خطا

برای اطلاعات در مورد معنی خطاهای تماس API و نحوه رسیدگی به آنها ، به پیامهای خطا مراجعه کنید.