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

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

Google Chat इवेंट, 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
इवेंट का सोर्स स्पेस और उपयोगकर्ता सिर्फ़ स्पेस
इस्तेमाल किए जा सकने वाले इवेंट
  • मैसेज
  • सदस्यताएं
  • प्रतिक्रियाएं
  • स्पेस

काम करने वाले इवेंट टाइप की सूची के लिए, Google Workspace Events API के दस्तावेज़ में सदस्यताएं बनाने के लिए इवेंट टाइप देखें.
  • मैसेज
  • सदस्यताएं
  • प्रतिक्रियाएं
  • स्पेस

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

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

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

  • कोई उपयोगकर्ता स्पेस में शामिल होता है, जिससे Membership रिसॉर्स बनता है और नया सदस्य इवेंट ट्रिगर होता है.
  • कोई उपयोगकर्ता स्पेस मैनेजर बन जाता है. इससे, उपयोगकर्ता के लिए Membership संसाधन अपडेट हो जाता है और सदस्यता से जुड़ा अपडेट किया गया इवेंट ट्रिगर हो जाता है.
  • कोई उपयोगकर्ता स्पेस छोड़ देता है. इससे, उपयोगकर्ता के लिए Membership संसाधन मिट जाता है और 'सदस्य को हटाया गया' इवेंट ट्रिगर होता है.

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

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

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

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

सीमाएं
  • उपयोगकर्ताओं की सदस्यताओं के लिए, डायरेक्ट मैसेज या बिना नाम वाली ग्रुप चैट (google.workspace.chat.membership.v1.created) में नए सदस्यों के बारे में इवेंट, सिर्फ़ पहला मैसेज पोस्ट होने के बाद ट्रिगर होते हैं.
  • सदस्यता से जुड़े इवेंट पाने के लिए, यह ज़रूरी है कि उपयोगकर्ता स्पेस का सीधा सदस्य हो. अगर किसी उपयोगकर्ता को किसी Google ग्रुप के ज़रिए स्पेस में जोड़ा, अपडेट या हटाया गया है, तो सदस्यता के उन इवेंट की सूचना सदस्यता को नहीं मिलेगी. Google ग्रुप की सदस्यताएं कैसे काम करती हैं, यह समझने के लिए, स्पेस में Google ग्रुप जोड़ना लेख पढ़ें.