تتكوّن السمة في واجهة برمجة تطبيقات SDM على الحقول والأوامر والأحداث.
الحقول
الحقول هي قيم ذات أنواع بيانات شائعة، مثل رقم أو سلسلة. على سبيل المثال، قد يتضمن أحد الحقول
الوضع الحالي أو الرطوبة المحيطة في جهاز Google Nest Thermostat.
يمكن عرض السمات والحقول باستخدام طلب البيانات GET لنقطة نهاية واجهة برمجة التطبيقات المطلوبة:
يجب ألّا يتم استخدام sdm.devices.types.device-type التي تعرضها واجهة برمجة تطبيقات SDM
لاستنتاج أو استنتاج وظيفة الجهاز الفعلي الذي تم تخصيصه له. وما من ضمانة بأنّ نوع الجهاز سيظل ثابتًا على جهاز معيّن، إذ تتم إضافة المزيد من الميزات إلى واجهة برمجة تطبيقات SDM. بدلاً من ذلك، استخدِم السمات المعروضة للجهاز.
parentRelations
يمثل الكائن parentRelations المورد الرئيسي للمورد الحالي،
سواء بنية أو غرفة. يتوافق الاسم المعروض مع الحقل customName في
سمة المعلومات
للأجهزة ذات البنية الرئيسية أو
سمة معلومات الغرفة {20.
الطلبات الصوتية
الأوامر هي طلبات مرتبطة بسمة معيّنة. على سبيل المثال، تغيير الوضع الحالي أو
نقطة ضبط درجة الحرارة على جهاز Google Nest Thermostat.
يتم إرسال الأمر من خلال طلب بيانات من واجهة برمجة التطبيقات executeCommand:
معظم الردود على أحد الأوامر هي نجاح بسيط أو فشل. يمكنك الاطّلاع على أدلة السمات الفردية للحصول على
أمثلة محدّدة على استخدام الأوامر.
فعاليات
يُرجى العلم أنّ الأحداث غير متزامنة وتتم إدارتها من خلال خدمة Google Cloud Pub/Sub في موضوع واحد حسب Project معرّف.
يتم إرسال الأحداث بشكل تلقائي لأي تغيير في قيمة حقل السمة. ويمكن أيضًا إرسالها
استجابةً لإجراءات محدّدة على الأجهزة أو للتغييرات في عمليات تخصيص الموارد. اطّلِع على
الأحداث
للحصول على مزيد من المعلومات.