تلتزم Google بتعزيز المساواة العرقية للمجتمعات السوداء. أنظر كيف.
ترجمت واجهة 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 القراءة والكتابة إلى أقسام من هذا المستند والاشتراك في التغييرات. تتيح إمكانية الاشتراك هذه إمكانية العمل مع منتجات Nest مع Nest في الوقت الفعلي للتفاعل مع التغييرات التي تم إجراؤها على النظام ، مثل إطفاء الأنوار عندما يقوم المستخدم بتعيين الهيكل على Away.

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

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

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

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

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

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

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

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

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

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

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

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

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