Pub/Sub सूचनाएं सेट अप करना

Pub/Sub सूचनाओं की मदद से, आपको नए डिवाइसों के रजिस्टर होने, डिवाइस की रिपोर्ट, और हाल ही में जारी की गई कमांड के बारे में सूचनाएं मिलती हैं.

Pub/Sub सूचनाएं सेट अप करने के लिए, आपको Pub/Sub API चालू करना होगा और एक विषय बनाना होगा. किसी विषय पर पब्लिश हुए मैसेज पाने के लिए, उस विषय की सदस्यता लें. सदस्यता, विषय को सदस्य के ऐप्लिकेशन से जोड़ती है. यह ऐप्लिकेशन, विषय पर पब्लिश किए गए मैसेज को पाता है और उन्हें प्रोसेस करता है. सदस्यता बनाने के बाद, आपको Android Device Policy को अपने विषय पर पब्लिश करने की अनुमति देनी होगी.

1. अपने प्रोजेक्ट के लिए Pub/Sub API चालू करना

Pub/Sub API को चालू करने के निर्देशों के लिए, Console की क्विकस्टार्ट गाइड देखें. पक्का करें कि आपने वही प्रोजेक्ट चुना हो जिसके लिए Android Management API चालू है.

2. कोई विषय बनाना

एपीआई चालू करने के बाद, आपको एक ऐसा विषय बनाना होगा जिस पर Android Device Policy सूचनाएं पब्लिश कर सके. विषय बनाने के दो तरीके हैं:

a. Google Cloud Console में जाकर, मैन्युअल तरीके से.
b. Pub/Sub API का इस्तेमाल करके (विषय बनाने का तरीका देखें).

विषय बनाने के बाद, विषय का नाम नोट कर लें.

3. सदस्यता बनाना

सदस्यता लेने पर, किसी विषय पर पब्लिश किए गए मैसेज की स्ट्रीम को कैप्चर किया जाता है. सदस्यता बनाने के दो तरीके हैं:

a. Google Cloud Console में जाकर, मैन्युअल तरीके से.
b. Pub/Sub API का इस्तेमाल करके (create subscription method देखें).

4. Android Device Policy ऐप्लिकेशन को अपने विषय पर पब्लिश करने का अधिकार देना

आपको android-cloud-policy@system.gserviceaccount.com को, अपने विषय पर पब्लिश करने की अनुमति देनी होगी. पब्लिश करने के अधिकार देने के दो तरीके हैं:

a. Google Cloud Console में जाकर, मैन्युअल तरीके से.

  • android-cloud-policy@system.gserviceaccount.com को अपने विषय का सदस्य बनाएं.
  • भूमिका चुनें > Pub/Sub > Pub/Sub पब्लिशर पर क्लिक करें.

b. Pub/Sub API का इस्तेमाल करना (IAM API के ज़रिए ऐक्सेस कंट्रोल करना लेख पढ़ें)

  • members में serviceAccount:android-cloud-policy@system.gserviceaccount.com जोड़ें.
  • role को roles/pubsub.publisher पर सेट करें.

5. सूचनाएं पाने के लिए, एंटरप्राइज़ खाते को अपडेट करना

अगर आपको जिस सूचना के लिए सहायता चाहिए वह ENTERPRISE_UPGRADE है, तो इस चरण को छोड़ दें. ENTERPRISE_UPGRADE के लिए हमेशा सहायता उपलब्ध होती है.

किसी एंटरप्राइज़ से जुड़ी सूचनाओं को आपके बनाए गए विषय से कनेक्ट करने के लिए, enterprises.patch को कॉल करें और इन पैरामीटर की जानकारी दें:

  • pubsubTopic: Pub/Sub विषय का नाम, projects/{project}/topics/{topic} के फ़ॉर्म में.
  • enabledNotificationTypes: इसमें सूचनाओं के वे सभी टाइप शामिल करें जिनकी सूचनाएं आपको चाहिए.

6. सूचनाएं पाने के लिए, Pub/Sub API का इस्तेमाल करना

सदस्यता लेने वाले लोगों को मैसेज डिलीवर करने के लिए, पुश या पुल मेकेनिज़्म का इस्तेमाल किया जा सकता है. इन दोनों तरीकों से सूचनाएं पाने के बारे में दिशा-निर्देश और निर्देश, Pub/Sub Subscriber Guide में उपलब्ध हैं.

मैसेज का फ़ॉर्मैट

मैसेज, PubsubMessage के फ़ॉर्मैट में होते हैं. मैसेज के attributes फ़ील्ड में, notificationType कुंजी वाला एट्रिब्यूट होता है. इसकी वैल्यू, सूचना के उस टाइप पर सेट होती है जिसकी वजह से मैसेज ट्रिगर हुआ है. उदाहरण के लिए, ENROLLMENT. मैसेज के data फ़ील्ड में, अपडेट किए गए संसाधन का JSON फ़ॉर्मैट होता है. इसे UTF-8 स्ट्रिंग के तौर पर कोड में बदला जाता है. सूचनाएं और उनसे जुड़े संसाधन टाइप यहां दिए गए हैं:

  • COMMAND सूचनाएं, Operation रिसॉर्स टाइप का इस्तेमाल करती हैं.
  • USAGE_LOGS सूचनाएं, UsageLogEvent रिसॉर्स टाइप का इस्तेमाल करती हैं.
  • ENROLLMENT और STATUS_REPORT सूचनाएं, डिवाइस रिसॉर्स टाइप का इस्तेमाल करती हैं.
  • ENTERPRISE_UPGRADE सूचनाएं, EnterpriseUpgradeEvent रिसॉर्स टाइप का इस्तेमाल करती हैं.

किसी एंटरप्राइज़ पर pubsubTopic सेट करते समय, एक शुरुआती मैसेज पब्लिश किया जाएगा. इसमें pubsubTopic को test पर सेट किया जाएगा.notificationType यह मैसेज इसलिए भेजा जाता है, ताकि यह पुष्टि की जा सके कि Android Device Policy ऐप्लिकेशन के पास विषय पर पब्लिश करने की अनुमति है. इसे अनदेखा किया जाना चाहिए.

अनुमानित लेटेन्सी

Enterprise अपग्रेड इवेंट तुरंत भेजे जाने चाहिए.

डिवाइस पर एक के बाद एक होने वाले इवेंट को बैच किया जाता है. इसके बाद, उन्हें ईएमएम को एक ही Pub/Sub मैसेज में रिपोर्ट किया जाता है.

इवेंट किस तरह का है डिवाइस पर होने वाले इवेंट और उससे जुड़ी ईएमएम सूचना के बीच इंतज़ार का अनुमानित समय1
ज़्यादा प्राथमिकता वाली ऐप्लिकेशन की मुख्य स्थितियां तुरंत, ज़्यादा से ज़्यादा एक रिपोर्ट हर मिनट
स्टैंडर्ड प्राथमिकता वाली ऐप्लिकेशन की मुख्य स्थितियां एक मिनट के अंदर
प्रोविज़निंग के दौरान ऐप्लिकेशन से जुड़े इवेंट. ये इवेंट, उन ऐप्लिकेशन के लिए होते हैं जिन्हें आईटी एडमिन ने इंस्टॉल किए जाने की स्थिति के हिसाब से तय किया है2 अन्य मिलती-जुलती प्रोविज़निंग की घटनाओं के एक मिनट के अंदर
आईटी एडमिन की ओर से इंस्टॉल करने की स्थिति तय किए जाने वाले ऐप्लिकेशन के लिए, प्रोविज़निंग के बाद ऐप्लिकेशन से जुड़े इवेंट. पांच मिनट के अंदर
प्रोविज़निंग के दौरान और बाद में, ऐप्लिकेशन से जुड़े इवेंट. ये ऐसे ऐप्लिकेशन के लिए होते हैं जिन्हें इंस्टॉल करने की स्थिति, कर्मचारी ने तय की है3 60 मिनट के अंदर
डिवाइस पर मौजूद ऐप्लिकेशन से जुड़े अन्य इवेंट 60 मिनट के अंदर

  1. कंट्रोल की गई स्थितियों के आधार पर, सबसे बेहतर कोशिशों वाले टारगेट. डिवाइस और आस-पास के माहौल से जुड़ी कई वजहों से, असल में होने वाली देरी में अंतर हो सकता है. ↩

  2. नीति में लागू किए गए ऐप्लिकेशन की InstallType: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED, और KIOSK. ↩

  3. InstallType उपलब्ध ऐप्लिकेशन: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩