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

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

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

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

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

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

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

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

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

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

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

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

4. Android Device Policy को अपने विषय से जुड़ा कॉन्टेंट पब्लिश करने का अधिकार दें

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

a. Google Cloud Platform कंसोल में मैन्युअल रूप से.

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

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

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

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

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

  • pubsubTopic: फ़ॉर्म में आपके पब/सब विषय का नाम 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 की सूचनाएं, रिसॉर्स टाइप डिवाइस का इस्तेमाल करती हैं.

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