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

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

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

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

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

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

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

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

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

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

गतिविधि Chat API का संसाधन इवेंट किस तरह का है
कोई उपयोगकर्ता, चैट स्पेस में मैसेज पोस्ट करता है एक 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 ऐप्लिकेशन चैट स्पेस के सदस्यों में हुए बदलावों के बारे में जानकारी. तय सीमा में स्पेस में, सदस्यता से जुड़ी ये गतिविधियां होती हैं:

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

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

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

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

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

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

हाल ही के सदस्यता इवेंट के लिए क्वेरी

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

वह चैट ऐप्लिकेशन जो
        Chat API.
तीसरी इमेज. ऐप्लिकेशन चैट ऐप्लिकेशन को हाल ही में सदस्यता के ये इवेंट मिलते हैं: 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 ग्रुप जोड़ना.