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

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

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

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

  • स्पेस में नए मैसेज मॉनिटर करें और उनका जवाब दें. जैसे, मुख्य शब्दों या वाक्यांशों की जांच करना.
  • स्पेस में शामिल होने वाले उपयोगकर्ताओं को वेलकम मैसेज भेजें. इसमें स्पेस के दिशा-निर्देशों के बारे में बताया जा सकता है या Chat ऐप्लिकेशन का असरदार तरीक़े से इस्तेमाल करने के बारे में सलाह शेयर की जा सकती है.
  • Chat पर की गई गतिविधि को ट्रैक करना और उसका विश्लेषण करना. उदाहरण के लिए, नए सदस्यों या सबसे ज़्यादा प्रतिक्रिया या जवाब पाने वाले मैसेज के बारे में हर महीने रिपोर्ट भेजना.
  • मैसेज सेवा देने वाले सभी प्लैटफ़ॉर्म पर दर्शकों से बातचीत करना. उदाहरण के लिए, उपयोगकर्ता Chat को छोड़े बिना किसी दूसरे मैसेजिंग प्लैटफ़ॉर्म पर उपयोगकर्ताओं के मैसेज भेज और पा सकते हैं.

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

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

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

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

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

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

Google Chat से इवेंट की जानकारी पाना

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

  • Google Workspace Events API का इस्तेमाल करके इवेंट की सदस्यता लें, ताकि इवेंट होने पर आपको उनकी सूचना मिल सके.
  • Chat API का इस्तेमाल करके, हाल ही के इवेंट की क्वेरी करें.

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

इवेंट की सदस्यता लेना इवेंट के लिए क्वेरी
इस्तेमाल के उदाहरण
  • रीयल टाइम में इवेंट प्रोसेस करें या उनके जवाब दें.
  • उपयोगकर्ताओं की सदस्यता से जुड़ी गतिविधि पर नज़र रखें और मॉनिटर करने के लिए नई जगहें खोजें.
  • समय-समय पर या ट्रिगर की मदद से, इवेंट प्रोसेस करें या उनके जवाब दें.
  • किसी सदस्यता (कुछ समय के लिए उपलब्ध न होने या सदस्यता बंद होने की वजह से) से छूटे हुए इवेंट फ़ेच करें.
API Google Workspace Events API Chat API
इवेंट का सोर्स स्पेस और उपयोगकर्ता सिर्फ़ स्पेस
इस्तेमाल किए जा सकने वाले इवेंट
  • मैसेज
  • पैसे चुकाकर ली जाने वाली सदस्यताएं
  • प्रतिक्रियाएं
  • सामाजिक स्थिति

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

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

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

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

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

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

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

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

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

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

हाल ही में पैसे चुकाकर ली गई सदस्यता वाले इवेंट के लिए क्वेरी

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

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

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

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

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