السمات

تتألف السمة في واجهة برمجة التطبيقات لمجموعة أدوات Smart Device Management من الحقول والطلبات والأحداث.

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

الحقول

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

يمكن عرض السمات والحقول من خلال طلب 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). بدلاً من ذلك، استخدِم السمات التي تم عرضها للجهاز.

parentRelations

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

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

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

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

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

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

الفعاليات

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

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

فئات السمات

البنية

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

الجهاز

السمات
الاتصال	sdm.devices.traits.Connectivity تنتمي هذه السمة إلى أي جهاز يتضمّن معلومات الاتصال بالشبكة.
Fan	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 التي يمكنها الإبلاغ عن تفاصيل التدفئة والتهوية وتكييف الهواء.
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 تنتمي هذه السمة إلى أي جهاز يتيح رنين جرس الباب وأحداث الضغط ذات الصلة.