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

Nest API Reference

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

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

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

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

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

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

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

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

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

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

داده ها و حریم خصوصی

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

درباره نظرات ما درباره حریم خصوصی اطلاعات بیشتری کسب کنید.

ابرداده

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

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

نشانه دسترسی

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

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

client_version

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

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

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

شناسه کاربر

شناسه کاربر به شما امکان می دهد تا کاربران را در تماس های API شناسایی کنید. این شناسه برای هر Works with Nest و ترکیب کاربر متفاوت است.

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

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