السمات

تتضمّن السمة في SDM API حقولاً وطلبات وأحداثًا.

يجب أن تستخدم جميع الطلبات إلى SDM API نقطة النهاية التالية:
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 API لاستنتاج وظائف الجهاز الفعلي الذي تم تعيينه إليه أو استنتاجها. لا نضمن بقاء نوع الجهاز ثابتًا لجهاز معيّن مع إضافة المزيد من الميزات إلى SDM API. بدلاً من ذلك، استخدِم السمات التي تم عرضها للجهاز.

parentRelations

يمثّل عنصر parentRelations المورد الرئيسي للمورد الحالي، سواء كان بنية أو غرفة. يتطابق الاسم المعروض مع حقل customName في Info للأجهزة التي لها بنية رئيسية أو سمة RoomInfo للأجهزة التي لها غرفة رئيسية.

الطلبات

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

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

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

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

الفعاليات

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

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

فئات السمات

البنية

السمات
معلومات	sdm.structures.traits.Info تنتمي هذه السمة إلى أي بنية للحصول على معلومات ذات صلة بالبنية.
RoomInfo	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 تنتمي هذه السمة إلى أي جهاز يتضمّن مستشعرًا لقياس درجة الحرارة.

ترموستات

السمات
ThermostatEco	sdm.devices.traits.ThermostatEco تنتمي هذه السمة إلى أنواع أجهزة THERMOSTAT التي تتيح أوضاع ECO.
ThermostatHvac	sdm.devices.traits.ThermostatHvac تنتمي هذه السمة إلى أنواع أجهزة THERMOSTAT التي يمكنها عرض تفاصيل HVAC.
ThermostatMode	sdm.devices.traits.ThermostatMode تنتمي هذه السمة إلى أنواع أجهزة THERMOSTAT التي تتيح أوضاع ترموستات مختلفة.
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint تنتمي هذه السمة إلى أنواع أجهزة THERMOSTAT التي تتيح ضبط درجة الحرارة المستهدَفة والنطاق الحراري.

الكاميرا

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

جرس الباب

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