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