Google is committed to advancing racial equity for Black communities. See how.

ساختار

سازه های

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

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

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

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

مجوزهای ساختار

برای دسترسی به ... انتخاب کنید...
بیشترین ارزش داده ها در structures شی دور ، زمان رسیدن به مقصد ، انرژی ، و یا پستی کد مجوز
name ارزش داده ها در structures شی ساختار خواندن / نوشتن اجازه

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

شناسه های ساختار

نام

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

هر کجا

wheres یک مجموعه شیء در یک ساختار، حاوی شناسه که در آن (است where_id و name ). استفاده از wheres برای ایجاد سفارشی که در آن نام، و یا استاندارد دسترسی که در آن نام.

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

where_id

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

name

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

اطلاعات بیشتر در مورد نام برای دما آشیانه ،آشیانه محافظت و آشیانه کم .

فراداده دیگر

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

مقدار داده شرح
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 ).

را ببینید دود + راهنمای زنگ CO برای اطلاعات بیشتر در این کشورها.

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

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

چندین ساختار

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

انتخاب کننده ساختار

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

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

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

تعداد دستگاههایی که Nest در یک ساختار پشتیبانی می کند محدودیت هایی دارد.

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

پیغام خطا

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