Google Chat के इवेंट की सदस्यता लेना

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

इवेंट की सदस्यता लेने के साथ-साथ, Chat API को कॉल करके भी इवेंट के बारे में क्वेरी की जा सकती है. Chat API को कॉल करने से, आपको समय-समय पर इवेंट वापस पाने में मदद मिलती है. इसके अलावा, अगर किसी गड़बड़ी की वजह से आपको सदस्यता से जुड़े इवेंट नहीं मिल पाए हैं, तो आपको उन इवेंट को वापस पाने में भी मदद मिलती है. Chat इवेंट पाने और उनका जवाब देने के तरीकों के बारे में जानने के लिए, Chat के दस्तावेज़ में Google Chat के इवेंट इस्तेमाल करना लेख पढ़ें.

चैट के लिए उपलब्ध इवेंट

Google Workspace की सदस्यताओं के ज़रिए, Chat में होने वाले इन बदलावों के बारे में सूचनाएं पाई जा सकती हैं:

• स्पेस में मौजूद मैसेज में हुए बदलावों के बारे में सूचनाएं. जैसे, नए मैसेज, अपडेट किए गए मैसेज या मिटाए गए मैसेज.
• किसी मैसेज पर नई प्रतिक्रियाएं दी गई हों या हटाई गई हों.
• स्पेस में सदस्यों को जोड़ा, हटाया या अपडेट किया गया हो.
• आपने जिस स्पेस की सदस्यता ली है उसमें किए गए बदलावों के बारे में सूचनाएं. जैसे, स्पेस के नाम या ब्यौरे में बदलाव.

ऐसे संसाधन जिनके इवेंट को मॉनिटर किया जा सकता है

इवेंट पाने के लिए, आपको मॉनिटर करने के लिए Chat रिसॉर्स तय करना होता है. इसे सदस्यता का टारगेट रिसॉर्स कहा जाता है.

Google Workspace Events API, Chat के लिए इन टारगेट रिसॉर्स के साथ काम करता है:

सदस्यताएं बनाने के लिए इवेंट टाइप

सदस्यता बनाते समय, आपको eventTypes[] फ़ील्ड का इस्तेमाल करके यह बताना होता है कि आपको किस तरह के इवेंट की सूचनाएं चाहिए. इवेंट टाइप को CloudEvents स्पेसिफ़िकेशन के मुताबिक फ़ॉर्मैट किया जाता है. जैसे, google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

उदाहरण के लिए, Chat स्पेस में शामिल होने वाले उपयोगकर्ताओं के बारे में इवेंट पाने के लिए, स्पेस को टारगेट रिसॉर्स के तौर पर और इवेंट टाइप को google.workspace.chat.membership.v1.created के तौर पर सेट करें. किसी स्पेस में शामिल होने वाले उपयोगकर्ता के बारे में इवेंट पाने के लिए, उपयोगकर्ता को टारगेट रिसॉर्स के तौर पर और इवेंट टाइप को google.workspace.chat.membership.v1.created के तौर पर सेट करें. इवेंट के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Google Workspace इवेंट का स्ट्रक्चर लेख पढ़ें.

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

बैच इवेंट के टाइप (सिर्फ़ आउटपुट)

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

उदाहरण के लिए, अगर कोई उपयोगकर्ता एक साथ 20 लोगों को किसी स्पेस में जोड़ता है, तो आपके Chat ऐप्लिकेशन को बैच इवेंट (google.workspace.chat.membership.v1.batchCreated) मिल सकता है. इवेंट पेलोड में, उन सभी नए Membership संसाधनों की सूची होती है जो उपयोगकर्ता के स्पेस में सदस्यों को जोड़ने पर बनाए गए थे.

आपने जिस भी इवेंट टाइप की सदस्यता ली है उसके लिए, आपको बैच इवेंट मिलता है. इसलिए, सदस्यता बनाते समय आपको बैच इवेंट तय करने की ज़रूरत नहीं होती. उदाहरण के लिए, अगर आपने नई प्रतिक्रियाओं (google.workspace.chat.reaction.v1.created) के लिए सदस्यता ली है, तो आपका Chat ऐप्लिकेशन, बैच रिएक्शन इवेंट (google.workspace.chat.reaction.v1.batchCreated) पाने के लिए अपने-आप कॉन्फ़िगर हो जाता है.

यहां दी गई टेबल में, सदस्यता के लिए संभावित बैच इवेंट दिखाए गए हैं:

इवेंट का डेटा

इस सेक्शन में, Chat में होने वाले इवेंट के लिए इवेंट डेटा और सैंपल पेलोड के बारे में बताया गया है.

जब आपकी Google Workspace सदस्यता को Chat से कोई इवेंट मिलता है, तो data फ़ील्ड में इवेंट का पेलोड होता है. इस पेलोड में, Google Workspace के उस संसाधन के बारे में जानकारी होती है जिसमें बदलाव हुआ है. उदाहरण के लिए, अगर आपने किसी स्पेस में सदस्यता से जुड़े इवेंट के लिए सदस्यता ली है, तो इन इवेंट के पेलोड में spaces.membership रिसॉर्स में हुए बदलाव के बारे में जानकारी होती है.

इवेंट पेलोड में मौजूद रिसॉर्स डेटा

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

इस टेबल में, चैट स्पेस spaces/AAAABBBBBB की सदस्यता लेने के लिए, JSON पेलोड के उदाहरण दिए गए हैं. सदस्यता को मिलने वाले हर इवेंट के लिए, पेलोड इवेंट के data फ़ील्ड में दिखता है:

{
    "message":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID",
        "sender":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "createTime": "2023-09-07T21:37:36.260127Z",
        "text": "Hello world",
        "thread":
        {
            "name": "spaces/SPACE_ID/threads/THREAD_ID"
        },
        "space":
        {
            "name": "spaces/SPACE_ID"
        },
        "argumentText": "Hello world"
    }
}
      

{
    "message":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID"
    }
}
      

{
    "membership":
    {
        "name": "spaces/SPACE_ID/members/MEMBER_ID",
        "state": "JOINED",
        "member":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "createTime": "1970-01-01T00:00:00Z",
        "role": "ROLE_MANAGER"
    }
}
      

{
    "membership":
    {
        "name": "spaces/SPACE_ID/members/MEMBER_ID"
    }
}
      

{
    "space":
    {
        "name": "spaces/SPACE_ID",
        "displayName": "Cymbal Sales",
        "spaceThreadingState": "THREADED_MESSAGES",
        "spaceType": "SPACE",
        "spaceDetails":
        {
            "description": "Sales team for Cymbal Labs."
        },
        "spaceHistoryState": "HISTORY_ON"
    }
}
      

{
    "space":
    {
        "name": "spaces/SPACE_ID"
    }
}
      

{
    "memberships": [
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID",
            "state": "JOINED",
            "member":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        },
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID",
            "state": "JOINED",
            "member":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        }
    ]
}
      

{
    "memberships": [
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID"
          }
        },
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID"
          }
        }
    ]
}
      

{
    "reaction":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
        "user":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "emoji":
        {
            "unicode": "😊"
        }
    }
}
      

{
    "reaction":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID"
    }
}
      

{
    "reactions": [
        {
          "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
            "user":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😊"
            }
          }
        },
        {
          "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
            "user":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😸"
            }
          }
        }
    ]
}
      

{
    "reactions": [
      {
        "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID"
        },
        "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
        }
      }
    ]
}
      

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

मिलते-जुलते विषय

• Google Workspace इवेंट का स्ट्रक्चर
• OAuth के दायरे चुनें
• Chat इवेंट पाने के लिए, सदस्यता लें