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