ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM).
مزيد من المعلومات
إعداد إشعارات EMM
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يُنشئ 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 |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Play uses EMM notifications, sent via Google Cloud Pub/Sub, to inform enterprises of events like app approvals or new device provisioning.\u003c/p\u003e\n"],["\u003cp\u003eEMMs can configure their systems to display alerts to IT administrators based on these notifications.\u003c/p\u003e\n"],["\u003cp\u003ePull notifications are the recommended method for receiving EMM notifications, offering advantages in setup and maintenance.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eEnterprises.pullNotificationSet\u003c/code\u003e and \u003ccode\u003eEnterprises.acknowledgeNotificationSet\u003c/code\u003e are used to manage the retrieval and acknowledgment of EMM notifications.\u003c/p\u003e\n"],["\u003cp\u003eVarious notification types correspond to specific events, such as app updates, install failures, and new device provisioning, though some have been deprecated.\u003c/p\u003e\n"]]],[],null,["# Set up EMM notifications\n\nGoogle Play generates notifications, referred to as **EMM notifications** , in\nresponse to various events that affect an enterprise. For example, when an app\nis approved, the system sends a `ProductApprovalEvent` notification.\n\nEMM notifications are associated with a specific [enterprise service account\n(ESA)](/android/work/overview#service_accounts). As an EMM, you can set up your\nconsole to display alerts or messages to enterprise IT administrators based on\nthe notifications that you receive.\n\nEMM notifications are sent using [Google Cloud\nPub/Sub](//cloud.google.com/pubsub/overview). For detailed information on how to\nset up a Pub/Sub notifications, see the [Subscriber\nOverview](//cloud.google.com/pubsub/docs/subscriber) and [Pull Subscriber\nGuide](//cloud.google.com/pubsub/docs/pull).\n\nTo confirm that you have successfully set up your system to receive EMM\nnotifications from Google Play and to retrieve the name of the Cloud Pub/Sub\ntopic that you need to connect your subscription to, call\n[`Enterprises.sendTestPushNotification`](/android/work/play/emm-api/v1/enterprises/sendTestPushNotification).\n\nSending a test notification validates your EMM integration with the Google Cloud\nPub/Sub service for the enterprise. If EMM notifications are properly\nconfigured, the API returns the following: \n\n {\n topic_name: \"/projects/project-name/topics/play-work-012345\",\n message_id: \"128976912439\"\n }\n\nPull notifications\n------------------\n\nGoogle Cloud Pub/Sub supports two different notification mechanisms: pull and\npush. However, only pull notifications are recommended. The pull approach\ndoesn't require any external server setup, and works with both programmatically\nand manually created ESAs. Another advantage of pull notifications is that they\nrequire little to no additional configuration or maintenance by your customers.\nuse\n[`Enterprises.pullNotificationSet`](/android/work/play/emm-api/v1/enterprises/pullNotificationSet)\nand\n[`Enterprises.acknowledgeNotificationSet`](/android/work/play/emm-api/v1/enterprises/acknowledgeNotificationSet)\nto receive and acknowledge EMM notifications over long-running outgoing\nconnections.\n\nWhen calling\n[`Enterprises.pullNotificationSet`](/android/work/play/emm-api/v1/enterprises/pullNotificationSet),\nwe recommend leaving the `requestMode` to its default value\n(`waitForNotifications`). This causes the request to wait until one or more\nnotifications are present before returning a response. If no notifications are\npresent after some time, the request returns an empty notification list, after\nwhich you can try the request again.\n\nAfter you receive notifications, call\n[`Enterprises.acknowledgeNotificationSet`](/android/work/play/emm-api/v1/enterprises/acknowledgeNotificationSet)\nto ensure that the same notifications aren't returned the next time you call\n`Enterprises.pullNotificationSet`.\n\nYou also have the option of setting `requestMode` to `returnImmediately` when\ncalling `Enterprises.pullNotificationSet`. You'll receive a response to the\nrequest immediately, containing any pending notifications or an empty list if no\nnotifications are present. This `requestMode` option may be useful when you\ninitially test your notifications implementation.\n\nExamples of EMM notifications\n-----------------------------\n\nHere are some examples of events and the notification types that they generate:\n\n**Note:** The following notification types have been deprecated:\n`ProductApprovalEvent`, `AppUpdateEvent`, `NewPermissionsEvent`,\n`AppRestrictionsSchemaChangeEvent`, `ProductAvailabilityChangeEvent`, and\n`NewDeviceEvent`. For `AppUpdateEvent`, you must use\n[high-priority update mode](/android/work/play/emm-api/update) as\nper our recommendations.\n\n| Description | Notification |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|\n| A test notification is requested via the [Google Play EMM API](/android/work/play/emm-api/v1/enterprises/sendTestPushNotification). You need to send a test notification to confirm that your system can receive the notifications that Google Play publishes, and to learn the topic name used for all notifications associated with Google Play. | `TestPushNotification` |\n| A newly provisioned device is ready to be managed by the [Google Play EMM API](/android/work/play/emm-api/v1). You can now call APIs that require the device's `deviceId` ([Installs](/android/work/play/emm-api/v1/installs), for example) and APIs that return a [Devices](/android/work/play/emm-api/v1/devices) resource. This notification is only sent after the first account is provisioned on a managed device. **DEPRECATED** | `NewDeviceEvent` |\n| An administrator marks an application as approved or unapproved in the managed Google Play console. **DEPRECATED** | `ProductApprovalEvent` |\n| A pending installation to a device times out. For example, a push install request is accepted, but the device is not reachable for several days, so the install cannot be confirmed. The system sends an install timeout notification. | `InstallFailureEvent` |\n| A new version of an app is published. The update is available to one or more, but not necessarily all, devices. **DEPRECATED** | `AppUpdateEvent` |\n| An app update requires a new permission to be approved by the admin, so that an update or a new install can occur. This notification is sent when the application's accepted permission set differs from the application's requested permissions set. **DEPRECATED** | `NewPermissionsEvent` |\n| A new version of an app is published that includes a new or modified [managed configurations schema](//developer.android.com/work/managed-configurations.html# define-configuration). When a developer uploads a new APK, Google Play compares the schema in the manifest to the schema in the previous version of the app. If the schema has changed, it notifies enterprises that have approved the app. **DEPRECATED** | `AppRestrictionsSchemaChangeEvent` |\n| An available app becomes unavailable, or an unavailable app is re-added to Google Play. The availability of the app changes if a developer unpublishes it, or it is removed from Google Play. The availability also changes if an unavailable app is re-added to Google Play. **DEPRECATED** | `ProductAvailabilityChangeEvent` |\n| A notification related to an enterprise upgrade. An enterprise upgrade is a process that upgrades a managed Google Play Accounts enterprise to a managed Google Domain. | `EnterpriseUpgradeEvent` |"]]
