Method: spaces.spaceEvents.list

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

उपयोगकर्ता की पुष्टि ज़रूरी है. इवेंट की सूची बनाने के लिए, पुष्टि किया गया उपयोगकर्ता स्पेस का सदस्य होना चाहिए.

उदाहरण के लिए, Google Chat स्पेस में मौजूद इवेंट की सूची देखना लेख पढ़ें.

एचटीटीपी अनुरोध

GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. Google Chat पर मौजूद उस स्पेस के संसाधन का नाम जहां इवेंट हुए हैं.

फ़ॉर्मैट: spaces/{space}.

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

ज़रूरी नहीं. स्पेस के ज़्यादा से ज़्यादा इवेंट लौटाए जा सकते हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

नेगेटिव वैल्यू से INVALID_ARGUMENT गड़बड़ी मिलती है.

pageToken

string

ज़रूरी नहीं. पेज टोकन, जो स्पेस में मौजूद सूची के इवेंट के पिछले कॉल से मिला है. अगला पेज देखने के लिए, यह डालें.

पेज पर नंबर डालते समय, स्पेस इवेंट की सूची में दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मैच होने चाहिए. दूसरे पैरामीटर के लिए अलग-अलग वैल्यू पास करने पर, अनचाहे नतीजे मिल सकते हैं.

filter

string

ज़रूरी है. क्वेरी फ़िल्टर.

आपको has : ऑपरेटर का इस्तेमाल करके, कम से कम एक इवेंट टाइप (eventType) बताना होगा. एक से ज़्यादा इवेंट टाइप के हिसाब से फ़िल्टर करने के लिए, OR ऑपरेटर का इस्तेमाल करें. अपने फ़िल्टर में, एक साथ होने वाले इवेंट टाइप को शामिल न करें. अनुरोध करने पर, उससे जुड़े बैच के इवेंट अपने-आप दिखते हैं. उदाहरण के लिए, अगर नए प्रतिक्रियाओं (google.workspace.chat.reaction.v1.created) के हिसाब से फ़िल्टर किया जाता है, तो सर्वर नए प्रतिक्रियाओं के बॅच इवेंट (google.workspace.chat.reaction.v1.batchCreated) भी दिखाता है. काम करने वाले इवेंट टाइप की सूची के लिए, SpaceEvents रेफ़रंस दस्तावेज़ देखें.

इसके अलावा, शुरू होने के समय (startTime) और खत्म होने के समय (endTime) के हिसाब से भी फ़िल्टर किया जा सकता है:

  • startTime: स्पेस के इवेंट की सूची बनाने के लिए, खास टाइमस्टैंप. 28 दिन पहले तक हुए इवेंट की सूची बनाई जा सकती है. अगर कोई तारीख नहीं दी गई है, तो पिछले 28 दिनों के स्पेस इवेंट की सूची दिखेगी.
  • endTime: वह टाइमस्टैंप जब तक स्पेस के इवेंट की सूची दिखती है. अगर कोई समय नहीं दिया गया है, तो अनुरोध के समय तक के इवेंट की सूची दिखती है.

शुरू या खत्म होने का समय बताने के लिए, RFC-3339 में बराबर = ऑपरेटर और फ़ॉर्मैट का इस्तेमाल करें. startTime और endTime, दोनों के हिसाब से फ़िल्टर करने के लिए, AND ऑपरेटर का इस्तेमाल करें.

उदाहरण के लिए, ये क्वेरी मान्य हैं:

startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"
startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")

ये क्वेरी अमान्य हैं:

startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"
eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"

अमान्य क्वेरी को सर्वर INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर देता है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

स्पेस के इवेंट की सूची बनाने के लिए जवाब देने वाला मैसेज.

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

JSON के काेड में दिखाना
{
  "spaceEvents": [
    {
      object (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
spaceEvents[]

object (SpaceEvent)

नतीजे, क्रम से दिखाए जाते हैं. सबसे पुराना इवेंट सबसे पहले दिखता है. ध्यान दें: सूची के अनुरोधों के लिए, स्पेस ऑब्जेक्ट में permissionSettings फ़ील्ड नहीं दिखाया जाता.

nextPageToken

string

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

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.