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

حول خدمة Nest

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

مثال على السحابة إلى السحابة

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

على سبيل المثال ، يقرأ منظم الحرارة درجة الحرارة المستهدفة من نموذج البيانات. يضبط درجة الحرارة المحيطة على قياسه الحالي ، ويرسل بيانات المستشعر إلى Home / Away Assist ، الذي يضبط وضع الهيكل وفقًا لذلك.

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

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

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

تمثل structures العش structures المادية في العالم الحقيقي. إنها بمثابة نقطة تنظيم devices وتخزين البيانات للمبنى ككل. عادة ، structure هو منزل المستخدم.

تمثل devices Nest devices المادية (منظمات الحرارة ، والحماية ، والكاميرات) داخل الهيكل.

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

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

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

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

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

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

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

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

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

الأذونات والترخيص

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

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

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

لمعرفة كيفية تفويض الاتصال بـ Nest API ، راجع نظرة عامة على التفويض .