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 डिवाइस नीति, सूचनाएं पब्लिश कर सके. विषय बनाने के दो तरीके हैं:

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

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

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

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

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

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 सूचना के लिए यह सुविधा चालू करनी है, तो यह चरण छोड़ दें. यह सुविधा हमेशा काम करती है.

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

  • pubsubTopic: projects/{project}/topics/{topic} फ़ॉर्मैट में, आपके Pub/Sub विषय का नाम.
  • 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_UPGRADE सूचनाएं, रिसॉर्स टाइप EnterpriseUpgradeEvent का इस्तेमाल करती हैं.

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

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

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

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

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

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

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

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