ईएमएम सूचनाएं सेट अप करना

Google Play, ईएमएम सूचनाएं जनरेट करता है. ये सूचनाएं, किसी एंटरप्राइज़ पर असर डालने वाले अलग-अलग इवेंट के जवाब में जनरेट होती हैं. उदाहरण के लिए, जब किसी ऐप्लिकेशन को मंज़ूरी मिलती है, तो सिस्टम ProductApprovalEvent सूचना भेजता है.

ईएमएम सूचनाएं, किसी खास एंटरप्राइज़ सेवा खाते (ईएसए) से जुड़ी होती हैं. ईएमएम के तौर पर, आपको मिलने वाली सूचनाओं के आधार पर, एंटरप्राइज़ के आईटी एडमिन को सूचनाएं या मैसेज दिखाने के लिए, अपना कंसोल सेट अप किया जा सकता है.

ईएमएम सूचनाएं, Google Cloud Pub/Sub का इस्तेमाल करके भेजी जाती हैं. Pub/Sub की सूचनाएं सेट अप करने के तरीके के बारे में ज़्यादा जानने के लिए, सदस्यों के बारे में खास जानकारी और सदस्यों को पुल करने के बारे में गाइड देखें.

Google Play से ईएमएम सूचनाएं पाने के लिए, आपने अपना सिस्टम सही से सेट अप किया है या नहीं, इसकी पुष्टि करने के लिए Enterprises.sendTestPushNotification को कॉल करें. साथ ही, उस Cloud Pub/Sub विषय का नाम भी पाएं जिससे आपको अपनी सदस्यता को कनेक्ट करना है.

टेस्ट सूचना भेजने से, यह पुष्टि होती है कि आपके ईएमएम को एंटरप्राइज़ के लिए Google Cloud की Pub/Sub सेवा के साथ इंटिग्रेट किया गया है. अगर ईएमएम सूचनाएं सही तरीके से कॉन्फ़िगर की गई हैं, तो एपीआई ये जानकारी दिखाता है:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

पुल नोटिफ़िकेशन

Google Cloud Pub/Sub, सूचना देने के दो अलग-अलग तरीकों के साथ काम करता है: पुल और पुश. हालांकि, हमारा सुझाव है कि सिर्फ़ पुल नोटिफ़िकेशन का इस्तेमाल करें. पुल अप्रोच के लिए, किसी बाहरी सर्वर को सेट अप करने की ज़रूरत नहीं होती. यह प्रोग्राम के हिसाब से बनाए गए और मैन्युअल तौर पर बनाए गए ईएसए, दोनों के साथ काम करता है. पुल सूचनाओं का एक और फ़ायदा यह है कि इसके लिए, आपके ग्राहकों को ज़्यादा कॉन्फ़िगरेशन या रखरखाव की ज़रूरत नहीं होती. लंबे समय तक चलने वाले आउटगोइंग कनेक्शन पर, ईएमएम सूचनाएं पाने और उन्हें स्वीकार करने के लिए, Enterprises.pullNotificationSet और Enterprises.acknowledgeNotificationSet का इस्तेमाल करें.

Enterprises.pullNotificationSet को कॉल करते समय, हमारा सुझाव है कि आप requestMode को उसकी डिफ़ॉल्ट वैल्यू (waitForNotifications) पर ही रहने दें. इससे अनुरोध, जवाब देने से पहले एक या उससे ज़्यादा सूचनाओं के मौजूद होने तक इंतज़ार करेगा. अगर कुछ समय बाद भी कोई सूचना नहीं मिलती है, तो अनुरोध करने पर आपको खाली सूचना सूची दिखेगी. इसके बाद, अनुरोध फिर से किया जा सकता है.

सूचनाएं मिलने के बाद, Enterprises.acknowledgeNotificationSet को कॉल करें. इससे यह पक्का किया जा सकेगा कि अगली बार Enterprises.pullNotificationSet को कॉल करने पर, आपको वही सूचनाएं न मिलें.

Enterprises.pullNotificationSet को कॉल करते समय, आपके पास requestMode को returnImmediately पर सेट करने का विकल्प भी है. आपको अनुरोध का जवाब तुरंत मिल जाएगा. इसमें, वे सभी सूचनाएं शामिल होंगी जो आपने अभी तक नहीं देखी हैं. अगर कोई सूचना नहीं है, तो आपको खाली सूची दिखेगी. यह 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
किसी डिवाइस पर इंस्टॉल होने का इंतज़ार खत्म हो गया हो. उदाहरण के लिए, पुश इंस्टॉल के अनुरोध को स्वीकार कर लिया गया है, लेकिन डिवाइस कई दिनों से ऐक्सेस नहीं किया जा सकता. इसलिए, इंस्टॉल की पुष्टि नहीं की जा सकती. सिस्टम, इंस्टॉल के टाइम आउट की सूचना भेजता है.InstallFailureEvent
ऐप्लिकेशन का नया वर्शन पब्लिश किया गया हो. अपडेट एक या एक से ज़्यादा डिवाइसों के लिए उपलब्ध है. हालांकि, यह ज़रूरी नहीं है कि यह सभी डिवाइसों के लिए उपलब्ध हो. इस्तेमाल नहीं किया जा सकता AppUpdateEvent
ऐप्लिकेशन अपडेट करने के लिए, एडमिन से नई अनुमति लेनी पड़ती है, ताकि ऐप्लिकेशन को अपडेट किया जा सके या नया ऐप्लिकेशन इंस्टॉल किया जा सके. यह सूचना तब भेजी जाती है, जब ऐप्लिकेशन के लिए अनुमति का जो सेट स्वीकार किया गया है वह ऐप्लिकेशन के लिए अनुमति के जिस सेट का अनुरोध किया गया है उससे अलग हो. इस्तेमाल नहीं किया जा सकता NewPermissionsEvent
ऐप्लिकेशन का नया वर्शन पब्लिश किया गया हो, जिसमें नया या बदला गया मैनेज किए जा रहे कॉन्फ़िगरेशन स्कीमा शामिल हो. जब कोई डेवलपर नया APK अपलोड करता है, तो Google Play, मेनिफ़ेस्ट में मौजूद स्कीमा की तुलना, ऐप्लिकेशन के पिछले वर्शन में मौजूद स्कीमा से करता है. अगर स्कीमा बदला है, तो यह उन एंटरप्राइज़ को सूचना देता है जिन्होंने ऐप्लिकेशन को मंज़ूरी दी है. अब काम नहीं करता AppRestrictionsSchemaChangeEvent
कोई ऐप्लिकेशन उपलब्ध न हो या कोई ऐप्लिकेशन Google Play पर फिर से जोड़ा जाए. अगर कोई डेवलपर ऐप्लिकेशन को अनपब्लिश करता है या उसे Google Play से हटाता है, तो ऐप्लिकेशन की उपलब्धता बदल जाती है. अगर किसी ऐप्लिकेशन को Google Play पर फिर से जोड़ा जाता है, तो उसकी उपलब्धता भी बदल जाती है. इस्तेमाल नहीं किया जा सकता ProductAvailabilityChangeEvent
एंटरप्राइज़ वर्शन अपग्रेड करने से जुड़ी सूचना. एंटरप्राइज़ अपग्रेड, एक ऐसी प्रोसेस है जिसकी मदद से, मैनेज किए जा रहे Google Play खातों के एंटरप्राइज़ को, मैनेज किए जा रहे Google डोमेन में अपग्रेड किया जाता है. EnterpriseUpgradeEvent