السمات

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

parentRelations

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