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

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

इवेंट की सूचना पाने के लिए सदस्यता लेने के अलावा, Google Chat API को कॉल करके भी इवेंट के बारे में क्वेरी की जा सकती है. Chat API को कॉल करने से, आपको समय-समय पर इवेंट मिलते रहते हैं. इसके अलावा, अगर किसी गड़बड़ी की वजह से आपको सदस्यता से जुड़े इवेंट नहीं मिल पाए हैं, तो आपको वे इवेंट भी मिल जाते हैं. Chat इवेंट पाने और उनका जवाब देने के तरीकों के बारे में जानने के लिए, Chat के दस्तावेज़ में 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",
        }
      }
    ]
}
      

{
  "spaceReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/spaceReadState",
    "lastReadTime": "2026-04-14T14:03:46.431760Z"
  }
}
      

{
  "spaceReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/spaceReadState"
  }
}
      

{
  "threadReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/threads/THREAD_ID/threadReadState",
    "lastReadTime": "2026-04-14T14:03:46.431760Z"
  }
}
      

{
  "threadReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/threads/THREAD_ID/threadReadState"
  }
}
      

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

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

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