- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह Google Chat के किसी स्पेस के इवेंट की सूची बनाता है. हर इवेंट के लिए, payload में Chat संसाधन का सबसे नया वर्शन शामिल होता है. उदाहरण के लिए, अगर स्पेस के नए सदस्यों के बारे में इवेंट की सूची बनाई जाती है, तो सर्वर Membership
ऐसे संसाधन दिखाता है जिनमें सदस्यता की नई जानकारी शामिल होती है. अगर अनुरोध की गई अवधि के दौरान, नए सदस्यों को हटाया गया है, तो इवेंट पेलोड में Membership
संसाधन खाली है.
इसके लिए, उपयोगकर्ता की पहचान की पुष्टि करना ज़रूरी है. इवेंट की सूची बनाने के लिए, ज़रूरी है कि पुष्टि किया गया उपयोगकर्ता स्पेस का सदस्य हो.
उदाहरण के लिए, Google Chat स्पेस के इवेंट की सूची बनाना लेख पढ़ें.
एचटीटीपी अनुरोध
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. उस Google Chat स्पेस के संसाधन का नाम जहां इवेंट हुआ. फ़ॉर्मैट: |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize |
ज़रूरी नहीं. स्पेस इवेंट लौटाए जाने की ज़्यादा से ज़्यादा संख्या. सेवा, इस वैल्यू से कम वैल्यू दिखा सकती है. नेगेटिव वैल्यू दिखाने पर |
pageToken |
पेज का टोकन, जो स्पेस इवेंट की पिछली सूची में शामिल कॉल से मिला है. बाद वाला पेज फिर से पाने के लिए यह विकल्प दें. पेज को क्रम में लगाते समय, स्पेस इवेंट की सूची बनाने के लिए दिए गए अन्य सभी पैरामीटर, उस कॉल से मैच होने चाहिए जो पेज टोकन दिया गया था. दूसरे पैरामीटर में अलग-अलग वैल्यू पास करने पर, अनचाहे नतीजे मिल सकते हैं. |
filter |
ज़रूरी है. क्वेरी का फ़िल्टर. आपको इसके अलावा, शुरुआत के समय (
शुरू या खत्म होने का समय बताने के लिए, RFC-3339 में उदाहरण के लिए, नीचे दी गई क्वेरी मान्य हैं:
ये क्वेरी अमान्य हैं:
सर्वर अमान्य क्वेरी को |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
स्पेस में होने वाले इवेंट की लिस्टिंग के लिए रिस्पॉन्स मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"spaceEvents": [
{
object ( |
फ़ील्ड | |
---|---|
spaceEvents[] |
नतीजे, समय के हिसाब से दिखाए जाते हैं (सबसे पुराना इवेंट पहले). |
nextPageToken |
ज़्यादा इवेंट फ़ेच करने के लिए, कंटिन्यूशन टोकन का इस्तेमाल किया गया. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होगा. |
अनुमति के दायरे
इनमें से किसी एक 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
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.