Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

مرجع API Nest

Nest API یک خانه یا ساختمان فیزیکی را به عنوان یک سازه با ترموستات یادگیری Nest ، Nest Protects و Nest Cams به عنوان دستگاههایی در ساختار مدل می کند. این ساختار همچنین حاوی اطلاعاتی در مورد خانه به طور کلی (مانند حالت Away یا ETA یا Rush Hours فعال) است.

هر عنصر داده ای در ساختار توسط یک URL منبع (که "مکان های داده" نامیده می شود) در یک سند مشترک JSON قابل آدرس دهی است. هر مکان داده می تواند رشته ها ، اعداد ، بولیان ها ، اشیا parent والدین / کودک یا آرایه ها را ذخیره کند.

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

از طریق API ، می توانید داده ها را از مکان ها در چندین سطح در مدل داده همگام سازی کنید ، به عنوان مثال:

  • یک ساختار کامل ، شامل همه دستگاه ها
  • یک دستگاه واحد در یک ساختار
  • گروهی از مقادیر داده (دمای فعلی و محیط)
  • یک مقدار داده واحد (حالت سلامت باتری)

محصولات شما باید متفکرانه به رویدادهایی از این قبیل پاسخ دهند:

  • حضور (خانه و خارج از خانه)
  • ایمنی (دود و مونوکسید کربن)
  • استفاده از انرژی در اوقات گران قیمت روز
  • حوادث (صدا و حرکت)

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

مجوزها و داده های دستگاه مشترک

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

برای اطلاعات بیشتر ، به نمای کلی مجوزها مراجعه کنید.

اطلاعات و حریم خصوصی

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

درباره دیدگاه های ما درباره حریم خصوصی بیشتر بدانید.

فراداده

فراداده اطلاعات اضافی است که هنگام تماس با نقطه پایان سطح ریشه ارائه می شود:

https://developer-api.nest.com/

نشانه دسترسی

پس از اجازه کاربر ، محصول شما برای برقراری تماس API با سرویس Nest از رمز دسترسی استفاده می کند. این رمز دسترسی به منزله اثبات این موضوع است که کاربر به محصول شما اجازه برقراری تماس از طرف او را داده است.

جزئیات
برمی گردد string
مثال: "c.FmDPkzyzaQe ..."

تبدیل مشتری

نسخه مشتری آخرین نسخه مشتری است که توسط کاربر مجاز است و با access_token .

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

جزئیات
برمی گردد number
مثالها: 1 ، 17 ، 42

شناسه کاربری

شناسه کاربر به شما امکان می دهد کاربران را از طریق تماس های API شناسایی کنید. این شناسه برای هر محصول و ترکیب کاربر با Nest کار می کند متفاوت است.

به عنوان مثال ، اگر کاربر 1 مجاز به کار با محصول Nest A و کار با محصول Nest B باشد ، محصول A دارای یک مقدار user_id برای کاربر 1 است و محصول B دارای مقدار user_id متفاوت برای کاربر 1 است.

جزئیات
برمی گردد string
مثال: z.1.1.7DHps ...