الصفات

تشمل السمة في واجهة برمجة التطبيقات SDM الحقول والأوامر والأحداث.

يجب أن تستخدم جميع الطلبات الموجَّهة إلى واجهة برمجة التطبيقات SDM نقطة النهاية التالية:
https://smartdevicemanagement.googleapis.com/v1

الحقول

الحقول عبارة عن قيم ذات أنواع بيانات شائعة، مثل رقم أو سلسلة. على سبيل المثال، قد يحتوي أحد الحقول على الوضع الحالي أو مستوى الرطوبة المحيطة في ترموستات Google Nest.

يمكن عرض السمات والحقول باستخدام طلب GET إلى نقطة نهاية واجهة برمجة التطبيقات المطلوبة:

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

أنواع الأجهزة

يجب عدم استخدام sdm.devices.types.device-type التي تعرضها واجهة برمجة تطبيقات SDM لاستنتاج أو استنتاج الوظائف للجهاز الفعلي الذي تم تخصيصه لها. ما من ضمانة لأنّ نوع الجهاز سيظل ثابتًا لجهاز محدّد مع إضافة المزيد من الميزات إلى واجهة برمجة التطبيقات SDM. يمكنك بدلاً من ذلك استخدام السمات التي تم إرجاعها للجهاز.

العلاقات الأبوية

يمثل الكائن parentRelations المورد الرئيسي للمورد الحالي، سواء كان بنية أو غرفة. يتوافق الاسم المعروض مع الحقل customName في سمة المعلومات للأجهزة التي تتضمن عنصرًا رئيسيًا في البنية أو سمة معلومات الغرف {28/

الطلبات الصوتية

الأوامر هي الطلبات المرتبطة بسمة معيّنة. على سبيل المثال، يؤدي تغيير الوضع الحالي أو درجة الحرارة المثلى المضبوطة على الترموستات من Google Nest.

يتم إرسال الأمر من خلال استدعاء executeCommand لواجهة برمجة التطبيقات:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

تكون معظم الردود على أمر ناجحًا أو فاشلاً بسيطًا. يمكنك الاطّلاع على أدلة السمات الفردية للحصول على أمثلة محدّدة لاستخدام الأوامر.

الأحداث

الأحداث غير متزامنة وتتم إدارتها من خلال خدمة Cloud Pub/Sub من Google في موضوع واحد لكل Project معرّف.

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

فئات السمات

البنية

الصفات
معلومات	sdm.structures.traits.Info تنتمي هذه السمة إلى أي بنية للمعلومات المتعلقة بالبنية.
معلومات الغرفة	sdm.structures.traits.RoomInfo تنتمي هذه السمة إلى أي غرفة للحصول على معلومات متعلقة بالغرفة.

الجهاز

الصفات
إمكانية الاتصال	sdm.devices.traits.Connectivity تنتمي هذه السمة إلى أي جهاز يحتوي على معلومات الاتصال.
معجب	sdm.devices.traits.Fan وتتعلّق هذه الميزة بأي جهاز لديه القدرة على التحكم في المروحة.
الرطوبة	sdm.devices.traits.Humidity تنتمي هذه السمة إلى أي جهاز يتضمّن مستشعرًا لقياس نسبة الرطوبة.
معلومات	sdm.devices.traits.Info تنتمي هذه السمة إلى أي جهاز للحصول على معلومات ذات صلة بالجهاز.
الإعدادات	sdm.devices.traits.Settings تنتمي هذه السمة إلى أي جهاز للاطّلاع على معلومات الإعدادات المرتبطة بالجهاز.
درجة الحرارة	sdm.devices.traits.Temperature تنتمي هذه السمة إلى أي جهاز يتضمّن مستشعرًا لقياس درجة الحرارة.

ترموستات

الصفات
الترموستاتEco	sdm.devices.traits.ThermostatEco تنتمي هذه السمة إلى أنواع أجهزة الترموستات التي تتيح استخدام وضع "درجات حرارة اقتصادية".
الترموستات Hvac	sdm.devices.traits.ThermostatHvac تنتمي هذه السمة إلى أنواع أجهزة الترموستات التي يمكنها الإبلاغ عن تفاصيل أنظمة التدفئة والتهوية وتكييف الهواء.
الترموستاتالوضع	sdm.devices.traits.ThermostatMode تنتمي هذه السمة إلى أنواع أجهزة الترموستات التي تتيح استخدام أوضاع الترموستات المختلفة.
الترموستاتدرجة الحرارة عند نقطة الحرارة	sdm.devices.traits.ThermostatTemperatureSetpoint تنتمي هذه السمة إلى أنواع أجهزة الترموستات التي تتيح ضبط درجة الحرارة المستهدفة ونطاق درجة الحرارة.

الكاميرا

الصفات
معاينة مقطع الكاميرا	sdm.devices.traits.CameraClipPreview تنتمي هذه السمة إلى أي جهاز يتيح تنزيل معاينة المقطع.
صورة حدث الكاميرا	sdm.devices.traits.CameraEventImage تنتمي هذه السمة إلى أي جهاز يتيح إنشاء الصور من الأحداث.
صورة الكاميرا	sdm.devices.traits.CameraImage تنتمي هذه السمة إلى أي جهاز يتيح التقاط الصور.
CameraLiveStream	sdm.devices.traits.CameraLiveStream تنتمي هذه السمة إلى أي جهاز يتيح البث المباشر.
CameraMotion	sdm.devices.traits.CameraMotion تنتمي هذه السمة إلى أي جهاز يوفّر ميزة رصد الحركة.
كاميرا كاميرا	sdm.devices.traits.CameraPerson تنتمي هذه السمة إلى أي جهاز يتيح رصد أحداث رصد الأشخاص.
CameraSound	sdm.devices.traits.CameraSound تنتمي هذه السمة إلى أي جهاز يتيح رصد الصوت.

جرس الباب

الصفات
جرس جرس الباب	sdm.devices.traits.DoorbellChime تنتمي هذه السمة إلى أي جهاز يتوافق مع جرس الباب أو الأحداث الصحفية ذات الصلة.