Google Chat के इवेंट में हिस्सा लेना (original) (raw)

इस पेज पर बताया गया है कि Google Chat ऐप्लिकेशन, Google Chat में इवेंट कैसे पा सकते हैं और उनका जवाब कैसे दे सकते हैं.

Google Chat इवेंट, Chat में होने वाली किसी गतिविधि या बदलाव को दिखाता है. जैसे, किसी स्पेस में नया मैसेज. आपका Chat ऐप्लिकेशन, इवेंट का इस्तेमाल करके यह समझ सकता है कि क्या हुआ और उपयोगकर्ताओं के लिए काम की कार्रवाई कर सकता है या जवाब दे सकता है.

यहां इवेंट इस्तेमाल करने के कुछ उदाहरण दिए गए हैं:

इवेंट कैसे काम करते हैं

Google Chat में कोई भी गतिविधि होने पर, Google Chat API संसाधन बनाया, अपडेट किया या मिटाया जाता है. Chat, इवेंट का इस्तेमाल करके आपके Chat ऐप्लिकेशन को यह जानकारी देता है कि किस तरह की गतिविधि हुई है और Chat API के किस संसाधन पर इसका असर पड़ा है.

Google Chat स्पेस में पोस्ट किए गए मैसेज से इवेंट ट्रिगर होने का उदाहरण.

पहली इमेज. कोई उपयोगकर्ता किसी Chat स्पेस में मैसेज पोस्ट करता है. इससे Message संसाधन बनता है. इसके बाद, Chat एक ऐसा इवेंट बनाता है जिसमें नए मैसेज का डेटा शामिल होता है.

Chat, इवेंट को टाइप के हिसाब से कैटगरी में बांटता है. इवेंट टाइप की मदद से, सिर्फ़ अपनी ज़रूरत के हिसाब से जानकारी को फ़िल्टर किया जा सकता है और उसे पाया जा सकता है. साथ ही, एक जैसी गतिविधियों को एक ही तरीके से मैनेज किया जा सकता है.

यहां दी गई टेबल में बताया गया है कि Chat में की गई गतिविधि का असर, Chat API से जुड़ी किसी संसाधन पर कैसे पड़ता है. साथ ही, यह भी बताया गया है कि आपके Chat ऐप्लिकेशन को किस तरह का इवेंट मिलता है:

गतिविधि Chat API रिसॉर्स इवेंट किस तरह का है
जब कोई उपयोगकर्ता, Chat स्पेस में कोई मैसेज पोस्ट करता है Message संसाधन बनाया जाता है. नया मैसेज
कोई उपयोगकर्ता स्पेस मैनेजर बन जाता है. Membership संसाधन अपडेट किया गया है. अपडेट की गई सदस्यता
जब कोई उपयोगकर्ता किसी मैसेज पर प्रतिक्रिया देता है. Reaction संसाधन बनाया जाता है. नई प्रतिक्रिया
जब कोई उपयोगकर्ता किसी स्पेस को छोड़ देता है. Membership संसाधन मिटाया गया है. सदस्यता मिटाई गई

Google Chat से इवेंट पाना

इवेंट पाने के लिए, आपका Chat ऐप्लिकेशन इनमें से कोई एक काम कर सकता है:

यहां दी गई टेबल में, इवेंट के लिए क्वेरी करने या उनकी सदस्यता लेने के बीच का अंतर और इसकी वजहें बताई गई हैं:

इवेंट के लिए सदस्यता लेना इवेंट के लिए क्वेरी
उपयोग के उदाहरण इवेंट को रीयल टाइम में प्रोसेस करना या उनका जवाब देना. सदस्यों की सदस्यता से जुड़ी गतिविधि पर नज़र रखें. साथ ही, नज़र रखने के लिए नए स्पेस खोजें. इवेंट को समय-समय पर प्रोसेस करना या उनका जवाब देना या किसी ट्रिगर के ज़रिए ऐसा करना. किसी सदस्यता से छूटे हुए इवेंट फ़ेच करना. ऐसा किसी गड़बड़ी या सदस्यता के चालू न होने की वजह से हो सकता है.
एपीआई Google Workspace Events API Chat API
इवेंट का सोर्स स्पेस और उपयोगकर्ता सिर्फ़ स्पेस
इस्तेमाल किए जा सकने वाले इवेंट मैसेज सदस्यताएं प्रतिक्रियाएं स्पेस साथ काम करने वाले इवेंट टाइप की सूची देखने के लिए, Google Workspace Events API के दस्तावेज़ में सदस्यताएं बनाने के लिए इवेंट टाइप देखें. मैसेज सदस्यताएं प्रतिक्रियाएं स्पेस इवेंट टाइप की सूची देखने के लिए, Chat API के रेफ़रंस दस्तावेज़ में spaceEvents संसाधन देखें.
इवेंट का फ़ॉर्मैट CloudEvent स्पेसिफ़िकेशन के मुताबिक फ़ॉर्मैट किया गया Google Cloud Pub/Sub मैसेज. ज़्यादा जानकारी के लिए, Google Workspace इवेंट का स्ट्रक्चर देखें. Chat API का संसाधन ( spaces.spaceEvent)
इवेंट का डेटा Base64 में कोड में बदली गई स्ट्रिंग, जिसमें संसाधन का डेटा शामिल हो भी सकता है और नहीं भी. उदाहरण के लिए पेलोड देखने के लिए, इवेंट डेटा देखें. JSON पेलोड, जिसमें संसाधन का डेटा शामिल होता है. कुछ इवेंट टाइप में सिर्फ़ कुछ संसाधन फ़ील्ड शामिल होते हैं. उदाहरण के लिए पेलोड देखने के लिए, रेफ़रंस दस्तावेज़ देखें.

उदाहरण: किसी स्पेस में सदस्यता से जुड़े इवेंट के बारे में क्वेरी करना या उनकी सदस्यता लेना

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

पैसे चुकाकर ली जाने वाली सदस्यता से जुड़े इवेंट के लिए सदस्यता लेना

रीयल टाइम में इवेंट पाने के लिए, Chat ऐप्लिकेशन, Google Workspace Events API subscriptions.create() तरीके का इस्तेमाल करता है. इससे, सदस्यता से जुड़े सभी तरह के इवेंट के लिए स्पेस को सब्सक्राइब किया जा सकता है. सदस्यता बनाने के बाद, Chat ऐप्लिकेशन को सदस्यता से जुड़े इवेंट मिलने शुरू हो सकते हैं.

Chat ऐप्लिकेशन, जो Google Workspace Events API का इस्तेमाल करके इवेंट की सदस्यता लेता है.

दूसरी इमेज. Chat ऐप्लिकेशन, Google Workspace Events API का इस्तेमाल करके सदस्यता के ज़रिए सदस्यता के इवेंट पाता है.

दूसरी इमेज में दिखाया गया है कि Chat ऐप्लिकेशन के पास स्पेस की चालू सदस्यता है. इसलिए, जब भी स्पेस में सदस्यता में बदलाव होता है, तो ऐप्लिकेशन को इवेंट मिलता है. इसके बाद, Chat ऐप्लिकेशन इन गतिविधियों को रीयल टाइम में प्रोसेस कर सकता है या इनका जवाब दे सकता है. जैसे, स्पेस में शामिल होने वाले सदस्य को निजी तौर पर स्वागत मैसेज पोस्ट करना.

Google Workspace Events API का इस्तेमाल करके सदस्यताएं बनाने के बारे में जानने के लिए, Google Workspace Events API का दस्तावेज़ देखें.

हाल ही में हुई सदस्यता से जुड़ी घटनाओं के लिए क्वेरी

सदस्यता से जुड़े इवेंट होने पर सूचना पाने के बजाय, Chat ऐप्लिकेशन Chat API को कॉल करके, सदस्यता से जुड़ी गतिविधि के हाल ही के स्पेस इवेंट की सूची बना सकता है.

Chat ऐप्लिकेशन, जो Chat API का इस्तेमाल करके इवेंट के लिए क्वेरी करता है.

तीसरी इमेज. A Chat ऐप्लिकेशन, Chat API का इस्तेमाल करके स्पेस इवेंट के लिए क्वेरी करता है. इससे उसे सदस्यता से जुड़े हाल ही के इवेंट मिलते हैं.

तीसरी इमेज में, सदस्यता से जुड़ी सभी गतिविधियां पूरी होने के बाद, Chat ऐप्लिकेशन, Chat APIspaces.spaceEvents.list()मेथड को कॉल करता है. साथ ही, सदस्यता से जुड़े नए, अपडेट किए गए, और मिटाए गए इवेंट के लिए क्वेरी को फ़िल्टर करता है. Chat API, सदस्यता में हुए हर बदलाव को दिखाने वाले spaceEvent संसाधनों की सूची दिखाता है. इसके बाद, Chat ऐप्लिकेशन हाल ही की गतिविधि के आधार पर कार्रवाई कर सकता है या जवाब दे सकता है. जैसे, पिछले सात दिनों में स्पेस में सदस्यों की गतिविधि की खास जानकारी देने वाला मैसेज हर हफ़्ते पोस्ट करना.

Chat API का इस्तेमाल करके इवेंट के बारे में क्वेरी करने के लिए, Google Chat स्पेस से इवेंट की सूची बनाना लेख पढ़ें.

सीमाएं