بنية Nest API

لمحة عن خدمة Nest

تتيح تطبيقات Nest للمستخدمين الاتصال بمنزلهم من أي مكان. تتصل جميع أجهزة Nest (أجهزة الترموستات وأجهزة الحماية والكاميرات) وتطبيقات (iOS وAndroid وتطبيقات الويب) بخدمة Nest.

مثال على السحابة الإلكترونية

توفّر خدمة Nest نموذج بيانات للمنزل. قراءة الأجهزة والتطبيقات من نموذج البيانات هذا لاتخاذ الإجراء المناسب. يتم تحديث نموذج البيانات لعكس التغييرات في النظام.

على سبيل المثال، يقرأ الترموستات درجة الحرارة المستهدَفة من نموذج البيانات. فهي تضبط درجة الحرارة المحيطة على القياس الحالي وترسل بيانات جهاز الاستشعار إلى أداة المساعدة في الوضع "داخل المنزل/خارج المنزل" التي تضبط وضع البنية وفقًا لذلك.

تعمل أجهزة Nest في بيئات محدودة. الطاقة محدودة وإمكانية الاتصال بالشبكة المنزلية غير موثوق بها. يمكن أن تتيح منتجاتك وخدماتك استخدام خوارزميات الأجهزة لتوفير تجربة بسيطة وسهلة للمستخدمين.

نموذج البيانات

يتم تمثيل Nest API كمستند JSON يحتوي على سمات المستوى الأعلى وهي: metadata وdevices وstructures. تستخدم منتجات Works with Nest مستند JSON هذا للتفاعل مع أجهزة Nest والتفاعل مع تغييرات الحالة ذات الصلة والتفاعل معها.

Nest structures تمثّل الهياكل المادية في العالم الحقيقي. تعمل هذه الأجهزة كنقطة تنظيم في devices وتخزّن بيانات المبنى ككل. وعادةً ما تكون structure هي منزل المستخدِم.

Google Nestdevices تمثّل هذه الخاصية الأجهزة الفعلية (أجهزة الترموستات{/1} و"أجهزة الحماية" و"كاميرات" داخل مبنى).

يمكن معالجة كل عنصر بيانات في مستند JSON عن طريق عنوان URL (يُعرف أيضًا باسم "مواقع البيانات"). يمكن للعمل مع منتجات Nest قراءة أقسام هذا المستند والكتابة فيها والاشتراك في التغييرات. تسمح إمكانية الاشتراك هذه لمنتجات "العمل مع Nest" بالتفاعل في الوقت الفعلي مع التغييرات التي يتم إجراؤها على النظام، مثل إطفاء المصابيح عندما يضبط المستخدم البنية على "خارج المنزل".

تعمل العناصر أيضًا ضمن قيود فعلية. يحمي نموذج البيانات الأجهزة ومنزل المستخدم من خلال منع حدوث إجراءات مفاجئة وخطيرة. على سبيل المثال، لا يعمل الترموستات مع مكيّف الهواء في حال تفعيل "خاصية التدفئة الطارئة".

يمكنك استكشاف نموذج البيانات باستخدام مرجع واجهة برمجة التطبيقات التفاعلي هذا.

الحالة المقصودة

وتخزِّن خدمة Nest الحالة الموثوق بها للنظام، كما تشترك منتجات Nest with Works في التغييرات. يؤدي تعديل هذه الحالة (على سبيل المثال، تغيير درجة الحرارة المُستهدفة للترموستات) إلى إرسال الخدمة لإشعار تغيير إلى جميع المشتركين.

وبسبب التأخر في هذا النشر وقد تكون الشبكات غير موثوق بها، قد لا تكون الحالة التي يلاحظها المنتج هي الحالة التي تلاحظها حاليًا المنتجات الأخرى أو الخدمة الأخرى. تتم مزامنة الحالة في النهاية مع نقل الرسائل بين المنتجات المختلفة.

يوفّر نموذج النشر/الاشتراك هذا المستند إلى التفاعلات مع التطبيقات المتجاوبة.

استخدام خدمة Nest

للوصول إلى نقاط نهاية REST في خدمة Nest، يمكنك استخدام HTTPS في منتجك. يمكن استخدام العديد من مكتبات العملاء التابعة لجهات خارجية لهذا الغرض.

الأذونات والتفويض

نحن نسمح لمطوّري البرامج بإنشاء منتجات وخدمات تساعد في تحسين أداء المنازل بدون المساس بخصوصية المستخدمين وأمانهم. جميع اتصالاتنا آمنة، ويمنح المستخدم دائمًا إذن الوصول إلى البيانات بشكل صريح. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على الأذونات.

يتم التعامل مع التفويض من خلال بروتوكول OAuth 2.0. عندما يوافق المستخدم على منح حق الوصول إلى مستوى الإذن المطلوب، يصادق Nest على الطلب ويمنح مقدِّم الطلب رمز دخول. ويمكن استخدام رمز الدخول هذا للوصول إلى واجهة برمجة تطبيقات Nest والتفاعل مع بنيات المستخدم وأجهزته.

يؤدي منح رمز الدخول إلى إنشاء علاقة ثقة بين مستخدم ومنتج "يعمل مع Nest" وNest. يمكن للمستخدمين إبطال الوصول في أي وقت.

لمعرفة طريقة مصادقة اتصال Nest API، يُرجى الاطّلاع على نظرة عامة على التفويض.