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

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

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

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

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

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

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

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

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 संगठन ( डेवलपर के लिए झलक) सिर्फ़ स्पेस
काम करने वाले इवेंट
  • मैसेज
  • सदस्यताएं
  • प्रतिक्रियाएं
  • स्पेस

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

इवेंट टाइप की सूची देखने के लिए, Chat API के रेफ़रंस दस्तावेज़ में spaceEvents संसाधन देखें.
इवेंट का फ़ॉर्मैट CloudEvent स्पेसिफ़िकेशन के मुताबिक फ़ॉर्मैट किया गया Google Cloud Pub/Sub मैसेज. ज़्यादा जानकारी के लिए, 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 ऐप्लिकेशन के पास स्पेस की चालू सदस्यता है. इसलिए, जब भी स्पेस में सदस्यता में बदलाव होता है, तो ऐप्लिकेशन को एक इवेंट मिलता है. इसके बाद, Chat ऐप्लिकेशन इन गतिविधियों को रीयल टाइम में प्रोसेस कर सकता है या इनका जवाब दे सकता है. जैसे, स्पेस में शामिल होने वाले सदस्य को निजी तौर पर वेलकम मैसेज पोस्ट करना.

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

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

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

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

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

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

सीमाएं और डिलीवरी के तरीके

सामान्य सीमाएं

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

उपयोगकर्ता की सदस्यताएं

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

ग्राहक की सदस्यताएं ( डेवलपर के लिए झलक)

ग्राहक की सदस्यताओं के लिए, ये सीमाएं लागू होती हैं:

  • Google Workspace संगठन के पास कम से कम एक Enterprise एसकेयू का लाइसेंस होना चाहिए. ध्यान दें कि डेवलपर प्रीव्यू प्रोग्राम के दौरान, इस ज़रूरी शर्त का पालन करना ज़रूरी नहीं है. हालांकि, आने वाले समय में इसका पालन करना ज़रूरी होगा. इसके बारे में अलग से सूचना दी जाएगी.
  • Chat ऐप्लिकेशन, Google Workspace संगठन के लिए सिर्फ़ एक ग्राहक सदस्यता बना सकता है. Google Workspace संगठन के पास कुल पांच ग्राहक सदस्यताएं हो सकती हैं. ये सदस्यताएं, अलग-अलग Chat ऐप्लिकेशन से बनाई जाती हैं.

ग्राहक की सदस्यताओं के लिए, इवेंट डिलीवरी इन सामान्य नियमों का पालन करती है:

  • स्पेस में होने वाले इवेंट: ये सूचनाएं सिर्फ़ तब भेजी जाती हैं, जब इवेंट आपके Google Workspace संगठन के मैनेज किए जा रहे स्पेस में हो.
  • उपयोगकर्ता इवेंट: ये इवेंट सिर्फ़ तब डिलीवर किए जाते हैं, जब इवेंट आपके Google Workspace संगठन के किसी उपयोगकर्ता के लिए होता है.

इन नियमों का पालन न करने पर, सिर्फ़ पैसे चुकाकर ली जाने वाली सदस्यता से जुड़े इवेंट को छूट मिलती है. आपकी सदस्यता को, आपके संगठन के मैनेज किए गए स्पेस और बाहरी संगठनों के मैनेज किए गए स्पेस, दोनों से सदस्यता इवेंट मिल सकते हैं. हालांकि, ये इवेंट किस तरह डिलीवर किए जाते हैं, यह इस बात पर निर्भर करता है कि स्पेस को कौन मैनेज करता है:

आपके Google Workspace संगठन के मैनेज किए गए स्पेस

अगर Google Workspace इस्तेमाल करने वाले संगठन के मैनेज किए जा रहे स्पेस में सदस्यता में बदलाव होता है, तो इसे स्पेस इवेंट के तौर पर डिलीवर किया जाता है.

स्पेस इवेंट के रिसॉर्स का नाम इस फ़ॉर्मैट में होता है:

spaces/{spaceId}/spaceEvents/{spaceEventId}

संगठन से बाहर के लोगों के मैनेज किए गए स्पेस

अगर आपके Google Workspace संगठन के किसी उपयोगकर्ता की सदस्यता में बदलाव होता है, तो बाहरी संगठन के मैनेज किए जा रहे स्पेस (उदाहरण के लिए, बाहरी संगठन के मैनेज किए जा रहे स्पेस या बाहरी उपयोगकर्ता के बनाए गए डायरेक्ट मैसेज) में, आपकी सदस्यता को यह इवेंट उपयोगकर्ता इवेंट के तौर पर मिलता है.

उपयोगकर्ता इवेंट के रिसॉर्स का नाम इस फ़ॉर्मैट में होता है:

users/{userId}/userEvents/{userEventId}