تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

السمات

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

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

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 رقم التعريف:

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