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 के पास इस विषय पर कॉन्टेंट पब्लिश करने की अनुमति है. इसे अनदेखा किया जाना चाहिए.