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

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

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

Chat के साथ काम करने वाले इवेंट

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

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

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

इवेंट पाने के लिए, आपको 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 इवेंट का स्ट्रक्चर देखें.

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

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

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

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

आपको जिस भी इवेंट टाइप की सदस्यता लेनी है उसके लिए आपको बैच इवेंट मिलता है. इसलिए, सदस्यता बनाते समय आपको बैच इवेंट की जानकारी देने की ज़रूरत नहीं होती. उदाहरण के लिए, अगर आपने नई प्रतिक्रियाओं (google.workspace.chat.reaction.v1.created) की सदस्यता ली है, तो आपका चैट ऐप्लिकेशन, बैच प्रतिक्रिया इवेंट (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"
  }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "ACTIVE"
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "IDLE",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "AWAY",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "DO_NOT_DISTURB",
        "doNotDisturbMetadata": {
          "expirationTime": "2026-03-24T18:36:31.337Z"
        }
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "ACTIVE",
        "customStatus": {
          "text": "Be right back",
          "emoji": {
            "unicode": "👟"
          },
          "expireTime": "2026-03-24T18:38:05.583655Z"
        }
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

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

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

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

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

ग्राहक की सदस्यताएं

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

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

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

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

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

आपके Google Workspace संगठन की ओर से मैनेज किए जाने वाले स्पेस

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

स्पेस इवेंट के संसाधन के नाम के लिए, इस फ़ॉर्मैट का इस्तेमाल किया जाता है:

spaces/{spaceId}/spaceEvents/{spaceEventId}

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

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

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

users/{userId}/userEvents/{userEventId}

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

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