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

دود + هشدار CO

دود + دزدگیر CO

آشیانه حفاظت طراحی شده است برای تشخیص دود و مونواکسید کربن (CO) در یک محیط مسکونی، با چندین سنسور برای کمک به آن درک آنچه در خانه اتفاق می افتد.

API آشیانه دسترسی به داده های زیر در آشیانه حفاظت فراهم می کند:

  • وضعیت هشدار دود یا مونوکسیدکربن (CO)
  • وضعیت سلامتی باتری
  • آخرین وضعیت آزمون دستی و زمان سنجی
  • وضعیت آنلاین و آخرین اطلاعات اتصال
  • نام ساختار و دستگاه "Where name" (مکان در خانه)

مجوزهای دود + CO

برای دسترسی خواندن به همه + CO مقادیر داده زنگ API دود، را انتخاب کنید دود + CO به عنوان خوانده شده اجازه برای مشتری خود را.

هیچ اجازه نوشتن برای Smoke + CO alarm API در دسترس نیست.

شناسه های دود + CO

دستگاه

دستگاه های Nest بر اساس نوع به عنوان آرایه ای از شناسه ها لیست می شوند ، که می توانند برای شناسایی منحصر به فرد دستگاه از طریق مسیر دستگاه استفاده شوند. بنابراین یک + CO ID زنگ دود از "RTMTKxs..." بدان معنی است که شما می توانید + CO مدل دستگاه هشدار دود در بار devices/smoke_co_alarms/RTMTKxs... از طریق API.

وقتی دستگاه به چندین محصول متصل است ، هر توسعه دهنده شناسه متفاوتی را برای آن دستگاه می بیند. برای دستگاهی که چندین محصول از یک توسعه دهنده نصب کرده است ، توسعه دهنده شناسه مشابهی را می بیند.

نام

دو ویژگی نام ارائه شده است. کوتاه تر name مشخصه در برچسب رابط کاربر نمایش داده شده، در حالی که name_long در متن فرم بلند استفاده می شود.

name

در این مثال، name "آشیانه حفاظت از" است.

نام

name_long

در این مثال، name_long "آشیانه زیرزمین حفاظت از" است.

نام طولانی است

جایی که

where_id

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

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

where_name

هنگامی که شما را انتخاب نمایید دود + CO اجازه خواندن ، شما می توانید دستگاه دسترسی داشته باشید where_name از جسم دستگاه ( devices/smoke_co_alarms ).

فراداده دیگر

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

مقدار داده شرح
locale زبان و کد کشور اختصاص داده شده به این دستگاه
software_version رشته ای که نشان دهنده سیستم عامل فعلی نصب شده روی دستگاه است
structure_id رشته ای که منحصر به فرد این ساختار را نشان می دهد. این ساختاری است که دستگاه با آن جفت می شود
last_connection مهر زمان آخرین اتصال موفقیت آمیز به سرویس Nest
is_online وضعیت آنلاین این است که با استفاده از آشیانه تعیین last_connection زمان و پنجره اتصال مجدد انتظار می رود این است که دستگاه خاص.

ویژگی های دود + CO

سلامت باتری

استفاده از battery_health درست برای مشاهده وضعیت سلامت باتری.

مقدار شرح
ok میزان باتری خوب است
replace سطح باتری کم است ، باید تعویض شود

دزدگیر CO

استفاده از co_alarm_state درست برای مشاهده وضعیت زنگ CO.

مقدار شرح
ok عملکرد عادی
warning تشخیص افزایش سطح CO
emergency سطح CO بیش از حد بالا است ، کاربر باید از خانه خارج شود

دزدگیر دود

استفاده از smoke_alarm_state درست برای مشاهده وضعیت هشدار دود.

مقدار شرح
ok عملکرد عادی
warning تشخیص افزایش سطح دود
emergency سطح دود بیش از حد زیاد است ، کاربر باید از خانه خارج شود

آزمون دستی

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

حالت رنگ UI

برای اینکه آن را آسان تر برای طراحی یک رابط کاربری متقابل کالا منسجم، ما ارائه کرده ایم ui_color_state زمینه، که می دهد که نشانه سطح بالایی از دولت به طور کلی از آشیانه محافظت می کند. که از آن مشتق is_online ، battery_health ، co_alarm_state و smoke_alarm_state ، ارائه یک شرایط کلی که نشان دهنده شاخص رنگ واقعی نمایش داده شده در برنامه Nest .

پیغام خطا

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