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

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

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

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

Google Workspace की सदस्यता से आपको इवेंट से जुड़ी जानकारी मिलती है इस तरह के बदलाव होंगे:

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

इवेंट पर नज़र रखने के लिए संसाधन

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

Google Workspace Events API इन टारगेट संसाधनों के साथ काम करता है चैट के लिए:

टारगेट संसाधन फ़ॉर्मैट सीमाएं
स्पेस

//chat.googleapis.com/spaces/SPACE

जहां SPACE Chat API space संसाधन के संसाधन का नाम. आईडी को स्पेस के यूआरएल से लिया जा सकता है. इसके अलावा, spaces.list() तरीका.

Chat का इस्तेमाल करने वाले जिस उपयोगकर्ता ने सदस्यता की अनुमति दी है उसे यह ज़रूरी है Google Workspace या Google के ज़रिए स्पेस का सदस्य बन सकता है खाता.
उपयोगकर्ता के लिए सभी स्पेस

//chat.googleapis.com/spaces/-

सदस्यता में, उपयोगकर्ता को सिर्फ़ उन स्पेस के इवेंट मिलते हैं सदस्यता के लिए, उनके Google Workspace या Google खाते का इस्तेमाल करता है.
उपयोगकर्ता

//cloudidentity.googleapis.com/users/USER

जहां USER Chat API user संसाधन के संसाधन का नाम. जानकारी के लिए, यह देखें पहचान करें और बताएं Google Chat इस्तेमाल करने वाले लोग.

सदस्यता में, उस उपयोगकर्ता के सिर्फ़ ऐसे इवेंट शामिल होते हैं ने सदस्यता को अनुमति दी है. कोई उपयोगकर्ता इस पर सदस्यता को अनुमति नहीं दे सकता शेयर किया जा सकता है.

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

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

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

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

इवेंट का टाइप फ़ॉर्मैट संसाधन का डेटा
स्पेस की सदस्यताएं  
एक मैसेज पोस्ट किया गया.

google.workspace.chat.message.v1.created

space.message

मैसेज अपडेट किया गया.

google.workspace.chat.message.v1.updated

space.message

एक मैसेज मिटाया गया.

google.workspace.chat.message.v1.deleted

space.message

इसके बाद, एक प्रतिक्रिया तैयार हो जाएगी.

google.workspace.chat.reaction.v1.created

space.message.reaction

प्रतिक्रिया मिटा दी गई है.

google.workspace.chat.reaction.v1.deleted

space.message.reaction

स्पेस में एक सदस्य को जोड़ दिया गया है.

google.workspace.chat.membership.v1.created

space.membership

स्पेस में किसी सदस्य को अपडेट किया गया है.

google.workspace.chat.membership.v1.updated

space.membership

एक सदस्य को स्पेस से हटा दिया गया है.

google.workspace.chat.membership.v1.deleted

space.membership

स्पेस को अपडेट किया गया है.

google.workspace.chat.space.v1.updated

space

स्पेस को मिटा दिया गया है.

google.workspace.chat.space.v1.deleted

space

उपयोगकर्ताओं की सदस्यताएं  
उपयोगकर्ता, स्पेस का सदस्य बन जाता है.

सभी नए सदस्य इवेंट ट्रिगर नहीं करते. ज़्यादा जानकारी के लिए, सीमाएं देखें

google.workspace.chat.membership.v1.created

space.membership

स्पेस में उपयोगकर्ता की सदस्यता अपडेट हो जाती है.

google.workspace.chat.membership.v1.updated

space.membership

स्पेस के सदस्य को सीधे तौर पर स्पेस से हटा दिया जाता है.

google.workspace.chat.membership.v1.deleted

space.membership

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

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

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

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

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

बैच इवेंट का टाइप फ़ॉर्मैट
कई मैसेज पोस्ट किए गए हैं.

google.workspace.chat.message.v1.batchCreated

एक से ज़्यादा मैसेज अपडेट किए गए हैं.

google.workspace.chat.message.v1.batchUpdated

एक से ज़्यादा मैसेज मिटा दिए जाते हैं.

google.workspace.chat.message.v1.batchDeleted

कई प्रतिक्रियाएं जनरेट हो जाती हैं.

google.workspace.chat.reaction.v1.batchCreated

कई प्रतिक्रियाएं मिटा दी गई हैं.

google.workspace.chat.reaction.v1.batchDeleted

जिस स्पेस की सदस्यता ली गई है उसमें एक से ज़्यादा सदस्य जोड़ दिए गए हैं या सदस्यता लेने वाले उपयोगकर्ता को एक से ज़्यादा स्पेस में जोड़ दिया गया है.

google.workspace.chat.membership.v1.batchCreated

सदस्यता वाली जगह पर या उस उपयोगकर्ता के लिए, एक से ज़्यादा सदस्यताएं अपडेट हो जाती हैं जिसकी सदस्यता ली गई है.

google.workspace.chat.membership.v1.batchUpdated

जिस स्पेस की सदस्यता ली गई है उससे एक से ज़्यादा सदस्यों को हटा दिया जाता है. इसके अलावा, उन स्पेस से भी हटा दिया जाता है जिनकी सदस्यता ली गई है.

google.workspace.chat.membership.v1.batchDeleted

स्पेस में कई अपडेट हैं.

google.workspace.chat.space.v1.batchUpdated

इवेंट का डेटा

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

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

इवेंट पेलोड में संसाधन का डेटा

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

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

उदाहरण इवेंट का टाइप JSON पेलोड

किसी व्यक्ति ने स्पेस में "नमस्ते वर्ल्ड" मैसेज पोस्ट किया है.

google.workspace.chat.message.v1.created

संसाधन का डेटा शामिल है
{
    "message":
    {
        "name": "spaces/AAAABBBBBB/messages/CCCCCCCCC.DDDDDDDDD",
        "sender":
        {
            "name": "users/1234567890987654321",
            "type": "HUMAN"
        },
        "createTime": "2023-09-07T21:37:36.260127Z",
        "text": "Hello world",
        "thread":
        {
            "name": "spaces/AAAABBBBBB/threads/EEEEEEEEEEEE"
        },
        "space":
        {
            "name": "spaces/AAAABBBBBB"
        },
        "argumentText": "Hello world"
    }
}
      
संसाधन डेटा शामिल नहीं है
{
    "message":
    {
        "name": "spaces/AAAABBBBBB/messages/CCCCCCCCC.DDDDDDDDD"
    }
}
      
कोई उपयोगकर्ता, स्पेस मैनेजर बन जाता है.

google.workspace.chat.membership.v1.updated

संसाधन का डेटा शामिल है
{
    "membership":
    {
        "name": "spaces/AAAABBBBBB/members/1234567890987654321",
        "state": "JOINED",
        "member":
        {
            "name": "users/1234567890987654321",
            "type": "HUMAN"
        },
        "createTime": "1970-01-01T00:00:00Z",
        "role": "ROLE_MANAGER"
    }
}
      
संसाधन डेटा शामिल नहीं है
{
    "membership":
    {
        "name": "spaces/AAAABBBBBB/members/1234567890987654321"
    }
}
      
इस इमेज में दिखाया गया है कि कोई उपयोगकर्ता, स्पेस के ब्यौरे को "Simpal Labs की सेल्स टीम" में अपडेट करता है. google.workspace.chat.space.v1.updated
संसाधन का डेटा शामिल है
{
    "space":
    {
        "name": "spaces/AAAABBBBBB",
        "displayName": "Cymbal Sales",
        "spaceThreadingState": "THREADED_MESSAGES",
        "spaceType": "SPACE",
        "spaceDetails":
        {
            "description": "Sales team for Cymbal Labs."
        },
        "spaceHistoryState": "HISTORY_ON"
    }
}
      
संसाधन डेटा शामिल नहीं है
{
    "space":
    {
        "name": "spaces/AAAABBBBBB"
    }
}
      
स्पेस में एक ही समय पर दो Chat उपयोगकर्ताओं को जोड़ा गया. google.workspace.chat.membership.v1.batchCreated
संसाधन का डेटा शामिल है
{
    "memberships": [
        {
          "membership": {
            "name": "spaces/AAAABBBBBB/members/1234567890987654321",
            "state": "JOINED",
            "member":
            {
                "name": "users/1234567890987654321",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        },
        {
          "membership": {
            "name": "spaces/AAAABBBBBB/members/987654321234567890",
            "state": "JOINED",
            "member":
            {
                "name": "users/987654321234567890",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        }
    ]
}
      
संसाधन डेटा शामिल नहीं है
{
    "memberships": [
        {
          "membership": {
            "name": "spaces/AAAABBBBBB/members/1234567890987654321"
          }
        },
        {
          "membership": {
            "name": "spaces/AAAABBBBBB/members/98765432123456789019"
          }
        }
    ]
}
      
कोई उपयोगकर्ता, 😊 इमोजी का इस्तेमाल करके मैसेज पर प्रतिक्रिया देता है. google.workspace.chat.reaction.v1.created
संसाधन का डेटा शामिल है
{
    "reaction":
    {
        "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222",
        "user":
        {
            "name": "users/1234567890987654321",
            "type": "HUMAN"
        },
        "emoji":
        {
            "unicode": "😊"
        }
    }
}
      
संसाधन का डेटा हटा देता है
{
    "reaction":
    {
        "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222"
    }
}
      
उपयोगकर्ता, 😊 इमोजी और APNS इमोजी के ज़रिए मैसेज पर प्रतिक्रिया देते हैं. google.workspace.chat.reaction.v1.batchCreated
संसाधन का डेटा शामिल है
{
    "reactions": [
        {
          "reaction": {
            "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222",
            "user":
            {
                "name": "users/1234567890987654321",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😊"
            }
          }
        },
        {
          "reaction": {
            "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/3333333333333333.444444444444444",
            "user":
            {
                "name": "users/98765431234564321",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😸"
            }
          }
        }
    ]
}
      
संसाधन का डेटा हटा देता है
{
    "reactions": [
      {
        "reaction": {
            "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222"
        },
        "reaction": {
            "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/3333333333333333.444444444444444",
        }
      }
    ]
}
      

सीमाएं

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