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