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

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

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

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

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

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

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

a. يدويًا في Google Cloud Console.
ب. باستخدام واجهة برمجة تطبيقات Pub/Sub (راجِع إنشاء طريقة موضوع).

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

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

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

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

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

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

a. يدويًا في Google Cloud Console.

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

b. استخدام Pub/Sub API (راجِع التحكُّم في الوصول من خلال 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 لتلقّي الإشعارات

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

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

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

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

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

وقت الاستجابة المتوقَّع

يتم تجميع أحداث الجهاز المحلية التي تحدث بتتابع سريع وتسجيلها في رسالة نشر/اشتراك واحدة إلى مزوّدي خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM).

نوع الحدث	وقت الاستجابة المتوقَّع بين الحدث على الجهاز وإشعار إدارة الخدمات الجوّالة للمؤسسات (EMM) المقابل1
حالات التطبيق المستند إلى مفتاح ذات أولوية عالية	فوري، إبلاغ واحد على الأكثر في الدقيقة
حالات التطبيقات المستنِدة إلى مفتاح ذات الأولوية العادية	خلال دقيقة واحدة
الأحداث ذات الصلة بالتطبيقات أثناء توفير المتطلبات اللازمة، للتطبيقات التي تتضمّن حالات تثبيت يحدّدها مشرف تكنولوجيا المعلومات2	في غضون دقيقة واحدة فوق أحداث توفير المتطلبات اللازمة الأخرى
الأحداث ذات الصلة بالتطبيقات بعد توفير المتطلبات اللازمة، للتطبيقات التي تتضمّن حالات تثبيت يحدّدها مشرف تكنولوجيا المعلومات.	خلال 5 دقائق
الأحداث ذات الصلة بالتطبيقات أثناء توفير المتطلبات اللازمة وبعدها، للتطبيقات التي تتضمّن حالات تثبيت يحدّدها الموظف3	خلال 60 دقيقة
أحداث أخرى للتطبيقات على الجهاز فقط	خلال 60 دقيقة