يُنشئ Google Play إشعارات، يُشار إليها باسم إشعارات إدارة الخدمات الجوّالة للمؤسسات،
استجابةً لأحداث مختلفة تؤثّر في المؤسسة. على سبيل المثال، عندما يتم الموافقة على أحد التطبيقات، يُرسِل النظام إشعارًا ProductApprovalEvent.
تكون إشعارات إدارة الخدمات الجوّالة للمؤسسات مرتبطة بحساب خدمة مخصّص للمؤسسات (ESA). بصفتك مقدّم خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM)، يمكنك إعداد وحدتك التحكّم لعرض تنبيهات أو رسائل لمشرفي تكنولوجيا المعلومات في المؤسسات استنادًا إلى الإشعارات التي تتلقّاها.
يتم إرسال إشعارات إدارة الخدمات الجوّالة للمؤسسات باستخدام Google Cloud Pub/Sub. للحصول على معلومات مفصّلة حول كيفية إعداد إشعارات Pub/Sub، يُرجى الاطّلاع على نظرة عامة على Subscriber ودليل Subscriber Pull.
للتأكّد من أنّك أعددت نظامك بنجاح لتلقّي إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM)
من Google Play واسترداد اسم موضوع
Cloud Pub/Sub الذي تحتاج إلى ربط اشتراكك به، يُرجى الاتصال برقم Enterprises.sendTestPushNotification.
يؤكّد إرسال إشعار اختباري عملية دمج إدارة الخدمات الجوّالة للمؤسسات مع خدمة Google Cloud Pub/Sub للمؤسسة. في حال تم ضبط إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM) بشكلٍ سليم، تعرض واجهة برمجة التطبيقات ما يلي:
{
topic_name: "/projects/project-name/topics/play-work-012345",
message_id: "128976912439"
}
الإشعارات التي يتم طلبها
توفّر Google Cloud Pub/Sub آليتين مختلفتَين للإشعارات: سحب و
إرسال. ومع ذلك، ننصحك باستخدام الإشعارات التي يتم طلبها فقط. لا يتطلّب أسلوب السحب
أي إعداد خادم خارجي، ويعمل مع كلّ من تنسيقات ESA التي تم إنشاؤهابرمجيًا
وتلك التي تم إنشاؤها يدويًا. من المزايا الأخرى للإشعارات التي يتم طلبها أنّها
تتطلّب القليل من الإعداد أو الصيانة الإضافية أو لا تتطلّب أيًا منهما على الإطلاق من العملاء.
استخدِم Enterprises.pullNotificationSet
وEnterprises.acknowledgeNotificationSet
لتلقّي إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM) والردّ عليها من خلال اتصالات قيد التنفيذ منذ فترة طويلة.
عند استدعاء Enterprises.pullNotificationSet، ننصحك بإبقاء requestMode على قيمته التلقائية (waitForNotifications). يؤدي ذلك إلى انتظار الطلب إلى أن يظهر إشعار واحد أو أكثر قبل عرض ردّ. إذا لم تكن هناك إشعارات
متوفّرة بعد مرور بعض الوقت، يعرض الطلب قائمة إشعارات فارغة، وبعد
ذلك يمكنك إعادة إرسال الطلب.
بعد تلقّي الإشعارات، يُرجى الاتصال بالرقم
Enterprises.acknowledgeNotificationSet
لضمان عدم ظهور الإشعارات نفسها في المرة التالية التي تتصل فيها بالرقم
Enterprises.pullNotificationSet.
يمكنك أيضًا ضبط requestMode على returnImmediately عند
الاتصال بالرقم Enterprises.pullNotificationSet. سيصلك ردّ على
الطلب على الفور، يتضمّن أي إشعارات معلّقة أو قائمة فارغة في حال عدم توفّر
إشعارات. قد يكون خيار requestMode هذا مفيدًا عند
اختبار تنفيذ الإشعارات في البداية.
أمثلة على إشعارات إدارة الخدمات الجوّالة للمؤسسات
في ما يلي بعض الأمثلة على الأحداث وأنواع الإشعارات التي تنشئها:
ملاحظة: تم إيقاف أنواع الإشعارات التالية نهائيًا:
ProductApprovalEvent وAppUpdateEvent وNewPermissionsEvent
AppRestrictionsSchemaChangeEvent وProductAvailabilityChangeEvent و
NewDeviceEvent. بالنسبة إلى AppUpdateEvent، يجب استخدام
وضع التحديث ذو الأولوية العالية وفقًا
لاقتراحاتنا.
| الوصف | إشعار |
|---|---|
| يتم طلب إشعار اختباري من خلال Google Play EMM API. عليك إرسال إشعار اختباري للتأكّد من أنّه يمكن لنظامك تلقّي الإشعارات التي ينشرها Google Play، ومعرفة اسم الموضوع المستخدَم لجميع الإشعارات المرتبطة بـ Google Play. | TestPushNotification |
يصبح الجهاز الذي تم توفيره حديثًا جاهزًا لإدارة
Google Play EMM API. يمكنك الآن
استدعاء واجهات برمجة التطبيقات التي تتطلّب deviceId
(عمليات التثبيت، على سبيل المثال) و
واجهات برمجة التطبيقات التي تعرض مرجع الأجهزة. لا يتم إرسال هذا الإشعار إلا بعد توفير الحساب الأول
على جهاز مُدار.
متوقف
| NewDeviceEvent |
| يضع المشرف علامة على التطبيق تشير إلى أنّه تمت الموافقة عليه أو عدم الموافقة عليه في وحدة تحكّم Google Play للأعمال. متوقف | ProductApprovalEvent
|
| انتهاء مهلة عملية تثبيت معلّقة على جهاز على سبيل المثال، يتم قبول طلب تثبيت من خلال إرسال ملف APK، ولكن يتعذّر الوصول إلى الجهاز لعدة أيام، لذا لا يمكن تأكيد عملية التثبيت. يُرسِل النظام إشعارًا بشأن مهلة التثبيت. | InstallFailureEvent
|
| نشر إصدار جديد من أحد التطبيقات يتوفّر التحديث لجهاز واحد أو أكثر، ولكن ليس بالضرورة لجميع الأجهزة. متوقف | AppUpdateEvent
|
| يتطلّب تحديث التطبيق الحصول على إذن جديد من المشرف للسماح بإجراء التحديث أو التثبيت الجديد. يتم إرسال هذا الإشعار عندما تختلف مجموعة الأذونات المقبولة للتطبيق عن مجموعة الأذونات المطلوبة للتطبيق. متوقف | NewPermissionsEvent |
| نشر إصدار جديد من التطبيق يتضمّن مخطّط إعدادات مُدارة جديدًا أو معدَّلاً عندما يحمِّل المطوّر حزمة APK جديدة، يقارن Google Play المخطّط في البيان بالمخطّط في الإصدار السابق من التطبيق. وإذا تغيّر المخطّط، يتم إعلام المؤسسات التي وافقت على التطبيق. ميزة متوقّفة نهائيًا | AppRestrictionsSchemaChangeEvent |
| يصبح تطبيق متاح غير متاح، أو تتم إعادة إضافة تطبيق غير متاح إلى Google Play. يتغيّر مدى توفّر التطبيق إذا ألغى المطوّر نشره أو تمت إزالته من Google Play. ويتغيّر مدى التوفّر أيضًا في حال إعادة إضافة تطبيق غير متاح إلى Google Play. متوقف | ProductAvailabilityChangeEvent |
| إشعار مرتبط بترقية لإصدار Enterprise ترقية المؤسسة هي عملية ترقية "حسابات Google Play للأعمال" إلى "نطاق Google مُدار". | EnterpriseUpgradeEvent |