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

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

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

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

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

जांच की सूचना भेजने से, एंटरप्राइज़ के लिए Google CloudPub/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 ईएमएम एपीआई के ज़रिए किया जाता है. आपको इस बात की पुष्टि करने के लिए जांच की एक सूचना भेजनी होगी कि आपके सिस्टम को Google Play की ओर से प्रकाशित की जाने वाली सूचनाएं मिल सकती हैं या नहीं. साथ ही, आपको Google Play से जुड़ी सभी सूचनाओं के लिए इस्तेमाल किए जाने वाले विषय का नाम जानने के लिए भी एक सूचना भेजनी होगी.	TestPushNotification
एक नया प्रावधान किया गया डिवाइस Google Play ईएमएम API से मैनेज किए जाने के लिए तैयार है. अब उन एपीआई को कॉल किया जा सकता है जिन्हें डिवाइस के deviceId (उदाहरण के लिए, इंस्टॉल) और ऐसे एपीआई की ज़रूरत होती है जो डिवाइस संसाधन दिखाते हैं. यह सूचना सिर्फ़ तब भेजी जाती है, जब मैनेज किए जा रहे डिवाइस पर पहला खाता चालू किया जाता है. रोक दी गई है	NewDeviceEvent
एडमिन ने 'कारोबार के लिए Google Play कंसोल' में किसी ऐप्लिकेशन को 'स्वीकार किया गया' या 'अस्वीकार किया गया' के तौर पर मार्क किया होता है. रोक दी गई है	ProductApprovalEvent
किसी डिवाइस पर इंस्टॉल होने की प्रोसेस का समय खत्म हो गया है. उदाहरण के लिए, पुश इंस्टॉल करने का अनुरोध स्वीकार किया जाता है, लेकिन डिवाइस कई दिनों तक ऐक्सेस नहीं किया जा सकता. इसलिए, इंस्टॉल की पुष्टि नहीं की जा सकती. सिस्टम एक इंस्टॉल टाइम आउट सूचना भेजता है.	InstallFailureEvent
ऐप्लिकेशन का नया वर्शन पब्लिश किया गया. यह अपडेट एक या कई डिवाइसों के लिए उपलब्ध है. हालांकि, यह ज़रूरी नहीं है कि यह सभी डिवाइसों के लिए भी उपलब्ध हो. रोक दी गई है	AppUpdateEvent
ऐप्लिकेशन अपडेट करने के लिए नई अनुमति की ज़रूरत होती है, ताकि एडमिन को उसकी मंज़ूरी मिल सके. इससे ऐप्लिकेशन को अपडेट किया जा सकता है या कोई नया ऐप्लिकेशन इंस्टॉल किया जा सकता है. यह सूचना तब भेजी जाती है, जब ऐप्लिकेशन के लिए स्वीकार की गई अनुमति का सेट, ऐप्लिकेशन के लिए अनुरोध की गई अनुमतियों के सेट से अलग होता है. रोक दी गई है	NewPermissionsEvent
ऐप्लिकेशन का एक नया वर्शन पब्लिश किया गया है, जिसमें नया या बदला गया मैनेज किया गया कॉन्फ़िगरेशन स्कीमा शामिल है. जब कोई डेवलपर नया APK अपलोड करता है, तो Google Play मेनिफ़ेस्ट में मौजूद स्कीमा की तुलना ऐप्लिकेशन के पिछले वर्शन में मौजूद स्कीमा से करता है. अगर स्कीमा बदल जाता है, तो वह उन एंटरप्राइज़ को सूचना देता है जिन्होंने ऐप्लिकेशन को मंज़ूरी दी है. ऐसा नहीं किया गया	AppRestrictionsSchemaChangeEvent
उपलब्ध ऐप्लिकेशन अनुपलब्ध हो जाता है या अनुपलब्ध ऐप्लिकेशन Google Play में फिर से जोड़ दिया जाता है. अगर डेवलपर अपने ऐप्लिकेशन को अनपब्लिश कर देता है या Google Play से हटा दिया जाता है, तो उसकी उपलब्धता बदल जाती है. अगर किसी ऐप्लिकेशन को Google Play से फिर से जोड़ा जाता है, तो उपलब्धता भी बदल जाती है. रोक दी गई है	ProductAvailabilityChangeEvent