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 इन टारगेट संसाधनों के साथ काम करता है चैट के लिए:

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

सदस्यता बनाने के बाद, eventTypes[] फ़ील्ड का इस्तेमाल करें. इवेंट के टाइप ये हैं को CloudEvent की खास बातों के मुताबिक फ़ॉर्मैट किया जाता है, जैसे कि 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).

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

इवेंट का डेटा

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

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

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

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

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

{
    "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"
    }
}
      

{
    "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"
    }
}
      

{
    "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"
    }
}
      

{
    "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"
          }
        }
    ]
}
      

{
    "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"
    }
}
      

{
    "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 ग्रुप जोड़ना.

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

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