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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ب- باستخدام واجهة برمجة التطبيقات Pub/Sub (راجِع التحكّم في الوصول من خلال واجهة برمجة التطبيقات IAM)

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

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

تخطَّ هذه الخطوة إذا كان الإشعار الذي تريد إتاحة استخدامه هو ENTERPRISE_UPGRADE، الذي يمكن استخدامه دائمًا.

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

• pubsubTopic: اسم موضوع النشر/الاشتراك بالتنسيق projects/{project}/topics/{topic}
• enabledNotificationTypes: أدرِج جميع أنواع الإشعارات التي تريد تلقّيها.

6. استخدام واجهة برمجة تطبيقات Pub/Sub لتلقّي الإشعارات

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

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

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

• تستخدم إشعارات COMMAND نوع المورد Operation.
• تستخدم إشعارات USAGE_LOGS نوع المورد UsageLogEvent.
• تستخدم إشعارات ENROLLMENT وSTATUS_REPORT نوع المورد الجهاز.
• تستخدم إشعارات ENTERPRISE_UPGRADE نوع المورد EnterpriseUpgradeEvent.

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

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

من المتوقّع أن يتم إرسال أحداث الترقية إلى Enterprise على الفور.

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

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