إعداد إشعارات النشر/الاشتراك

توفِّر لك إشعارات النشر/الاشتراك طريقة لتلقّي تنبيهات حول الأجهزة التي تم تسجيلها حديثًا وتقارير الأجهزة والأوامر الصادرة مؤخرًا.

لإعداد إشعارات النشر/الاشتراك، عليك تفعيل واجهة برمجة تطبيقات النشر/الاشتراك وإنشاء موضوع. لتلقي الرسائل المنشورة حول موضوع ما، يمكنك إنشاء اشتراك في هذا الموضوع. يربط الاشتراك الموضوع بتطبيق مشترك يستقبل الرسائل المنشورة حول الموضوع ويعالجها. بعد إنشاء اشتراك، عليك منح تطبيق Android Device Policy إذن نشر موضوعك.

1- تفعيل واجهة برمجة تطبيقات Pub/Sub لمشروعك

للحصول على تعليمات عن كيفية تفعيل واجهة برمجة تطبيقات Pub/Sub، يُرجى الاطّلاع على دليل البدء السريع لوحدة التحكّم. تأكَّد من اختيار المشروع نفسه الذي تم تفعيل واجهة برمجة التطبيقات لإدارة Android فيه.

2. إنشاء موضوع

بعد تفعيل واجهة برمجة التطبيقات، عليك إنشاء موضوع يمكن لتطبيق Android Device Policy نشر الإشعارات عليه. هناك طريقتان لإنشاء موضوع:

a. يدويًا في وحدة تحكُّم Google Cloud Platform.
ب. باستخدام واجهة برمجة تطبيقات Pub/Sub (يُرجى الاطّلاع على إنشاء topicmethod).

بعد إنشاء موضوع، دوّن اسم الموضوع.

3. إنشاء اشتراك

يجمع الاشتراك سلسلة الرسائل المنشورة حول موضوع معيّن. تتوفّر طريقتان لإنشاء اشتراك:

a. يدويًا في وحدة تحكُّم Google Cloud Platform.
ب. باستخدام واجهة برمجة تطبيقات Pub/Sub (يُرجى الاطّلاع على إنشاء طريقة اشتراك).

4. منح تطبيق Android Device Policy الحق في النشر على موضوعك

يجب منح android-cloud-policy@system.gserviceaccount.com الإذن لنشر موضوعك. هناك طريقتان لمنح حقوق النشر:

a. يدويًا في وحدة تحكُّم Google Cloud Platform.

  • أضِف android-cloud-policy@system.gserviceaccount.com كعضو إلى موضوعك.
  • انقر على اختيار دور > نشر/اشتراك > ناشر/اشتراك.

b. باستخدام واجهة برمجة تطبيقات Pub/Sub (يُرجى الاطّلاع على التحكُّم في الوصول من خلال Google Cloud Pub/Sub IAM API)

  • أضِف serviceAccount:android-cloud-policy@system.gserviceaccount.com إلى members.
  • اضبط السمة role على roles/pubsub.publisher.

5. تحديث المؤسسة لإتاحة الإشعارات

لربط إشعارات عن مؤسسة بالموضوع الذي أنشأته، يمكنك استدعاء الرمز enterprises.patch وتحديد المَعلمات التالية:

  • pubsubTopic: اسم موضوع الناشر/الفرع الخاص بك بالصيغة projects/{project}/topics/{topic}.
  • enabledNotificationTypes: إدراج كل أنواع الإشعارات التي تريد تلقّيها اختر من بين ENROLLMENT وSTATUS_REPORT وCOMMAND.

6. استخدام Pub/Sub API لتلقّي الإشعارات

ويمكن أن يستخدم الاشتراك آلية الدفع أو السحب لتسليم الرسائل. تتوفّر إرشادات وتوجيهات حول كيفية تلقّي الإشعارات من خلال هاتَين الآليتَين في دليل المشترِكين في خدمة النشر/الاشتراكات.

تنسيق الرسالة

تكون الرسائل في شكل PubsubMessage. يتضمّن الحقل attributes في الرسالة سمة تتضمّن المفتاح notificationType وقيمة تم ضبطها على نوع الإشعار الذي أدّى إلى ظهور الرسالة (مثل ENROLLMENT). ويحتوي الحقل data من الرسالة على تمثيل JSON للمورِّد الذي تم تعديله، مع ترميزه كسلسلة UTF-8. الإشعارات وأنواع الموارد المقابلة لها هي:

  • تستخدم إشعارات COMMAND نوع المورد العملية.
  • تستخدم إشعارات USAGE_LOGS نوع المورد UsageLogEvent.
  • تستخدم إشعارات ENROLLMENT وSTATUS_REPORT نوع المورد Device.

عند إعداد pubsubTopic في Enterprise، سيتم نشر رسالة أولية مع ضبط notificationType على test. تم إرسال هذه الرسالة للتأكّد من أنّ تطبيق Android Device Policy لديه إذن نشر حول الموضوع ويجب تجاهله.