Method: spaces.messages.reactions.list

किसी मैसेज पर मिली प्रतिक्रियाओं की सूची दिखाता है. उदाहरण के लिए, किसी मैसेज पर की गई प्रतिक्रियाओं की सूची देखें.

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह मैसेज जिस पर उपयोगकर्ताओं ने प्रतिक्रिया दी है.

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

ज़रूरी नहीं. (अगर पिछली क्वेरी से फिर से शुरू किया जा रहा है.)

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

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

filter

string

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

प्रतिक्रियाओं को इमोजी (emoji.unicode या emoji.custom_emoji.uid) और उपयोगकर्ता (user.name) के हिसाब से फ़िल्टर किया जा सकता है.

एक से ज़्यादा इमोजी या उपयोगकर्ताओं की प्रतिक्रियाओं को फ़िल्टर करने के लिए, मिलते-जुलते फ़ील्ड को OR ऑपरेटर से जोड़ें. जैसे, emoji.unicode = "🙂" OR emoji.unicode = "👍" और user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

इमोजी और उपयोगकर्ता के हिसाब से प्रतिक्रियाओं को फ़िल्टर करने के लिए, AND ऑपरेटर का इस्तेमाल करें. जैसे, emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

अगर आपकी क्वेरी में AND और OR, दोनों का इस्तेमाल किया गया है, तो उन्हें ब्रैकेट में रखें.

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

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

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

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

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

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

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

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

प्रतिक्रियाओं की सूची के अनुरोध का जवाब.

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

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

object (Reaction)

अनुरोध किए गए (या पहले) पेज पर प्रतिक्रियाओं की सूची.

nextPageToken

string

नतीजों का अगला पेज पाने के लिए, कंटिन्यूएशन टोकन. नतीजों के आखिरी पेज के लिए, यह खाली होता है.

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

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

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

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