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

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

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

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

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

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

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

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

विषय बनाने के बाद, विषय के नाम पर ध्यान दें.

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

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

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

4. Android डिवाइस नीति को अपने विषय पर पब्लिश करने का अधिकार दें

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

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

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

b. Pub/Sub एपीआई का इस्तेमाल करना (IAM एपीआई से ऐक्सेस कंट्रोल करना देखें)

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

5. काम की सूचनाओं के लिए एंटरप्राइज़ को अपडेट करें

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

  • pubsubTopic: फ़ॉर्म में आपके pub/sub विषय का नाम projects/{project}/topics/{topic}.
  • enabledNotificationTypes: आपको जिन तरह की सूचनाएं चाहिए उन्हें शामिल करें. ENROLLMENT, STATUS_REPORT, और COMMAND में से चुनें.

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

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

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

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

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

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

अनुमानित इंतज़ार का समय

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

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

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

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

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