- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- इसे आज़माएं!
कॉल करने वाले व्यक्ति के उस स्पेस के मैसेज दिखाता है जिसका वह सदस्य है. इसमें, ब्लॉक किए गए सदस्यों और स्पेस के मैसेज भी शामिल होते हैं. अगर किसी ऐसे स्पेस के मैसेज की सूची बनाई जाती है जिसमें कोई मैसेज नहीं है, तो रिस्पॉन्स के तौर पर खाली ऑब्जेक्ट मिलता है. REST/एचटीटीपी इंटरफ़ेस का इस्तेमाल करने पर, रिस्पॉन्स में एक खाली JSON ऑब्जेक्ट, {}
होता है. उदाहरण के लिए, मैसेज की सूची देखें.
उपयोगकर्ता की पुष्टि ज़रूरी है.
एचटीटीपी अनुरोध
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. उस स्पेस का रिसॉर्स नेम जिसमें मौजूद मैसेज की सूची बनानी है. फ़ॉर्मैट: |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize |
ज़रूरी नहीं. एक बार में दिखाए जाने वाले मैसेज की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम मैसेज दिखाए. अगर कोई संख्या नहीं दी जाती है, तो ज़्यादा से ज़्यादा 25 आइटम दिखाए जाते हैं. ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. अगर 1,000 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो यह अपने-आप 1,000 हो जाती है. नेगेटिव वैल्यू देने पर, |
pageToken |
ज़रूरी नहीं. मैसेज की सूची दिखाने वाले पिछले कॉल से मिला पेज टोकन. अगला पेज देखने के लिए, यह पैरामीटर दें. पेजेशन करते समय, दिए गए अन्य सभी पैरामीटर उस कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया है. अन्य पैरामीटर को अलग-अलग वैल्यू देने से, अनचाहे नतीजे मिल सकते हैं. |
filter |
ज़रूरी नहीं. क्वेरी फ़िल्टर. मैसेज को तारीख ( मैसेज बनाने की तारीख के हिसाब से फ़िल्टर करने के लिए, थ्रेड के हिसाब से फ़िल्टर करने के लिए, थ्रेड और तारीख, दोनों के हिसाब से फ़िल्टर करने के लिए, अपनी क्वेरी में उदाहरण के लिए, ये क्वेरी मान्य हैं:
अमान्य क्वेरी को सर्वर, |
orderBy |
ज़रूरी नहीं. मैसेज की सूची को किस क्रम में लगाया जाता है. ऑर्डर करने के लिए कोई वैल्यू तय करें. ऑर्डर करने के लिए, ये वैल्यू मान्य हैं:
डिफ़ॉल्ट क्रम |
showDeleted |
ज़रूरी नहीं. मिटाए गए मैसेज शामिल करने हैं या नहीं. मिटाए गए मैसेज में, मिटाए जाने का समय और मेटाडेटा शामिल होता है. हालांकि, मैसेज का कॉन्टेंट उपलब्ध नहीं होता. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
सूची में शामिल मैसेज के लिए जवाब का मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"messages": [
{
object ( |
फ़ील्ड | |
---|---|
messages[] |
मैसेज की सूची. |
nextPageToken |
नतीजों का अगला पेज पाने के लिए, |
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.