تلتزم Google بتعزيز المساواة العرقية للمجتمعات السوداء. أنظر كيف.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

مرجع Nest API

يقدم Nest API نموذجًا لمنزلك أو مبنى ماديًا كهيكل ، مع أجهزة Nest Learning Thermostats و Nest Protects و Nest Cams كأجهزة في الهيكل. تحتوي هذه البنية أيضًا على معلومات حول المنزل ككل (مثل حالة Away أو ETA ، أو ساعات الذروة النشطة).

يمكن معالجة كل عنصر بيانات في البنية من خلال عنوان URL لمورد (يسمى "مواقع البيانات") في مستند JSON مشترك. يمكن لكل موقع بيانات تخزين السلاسل أو الأرقام أو القيم المنطقية أو كائنات الأصل / الطفل أو المصفوفات.

استكشف نموذج البيانات مع مرجع 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 ...