ساختار

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

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 و نحوه رسیدگی به آنها ، به پیامهای خطا مراجعه کنید.