Method: spaces.messages.reactions.list

यह किसी मैसेज पर प्रतिक्रियाएं देने के लिए इस्तेमाल किया जाता है. उदाहरण के लिए, मैसेज के लिए प्रतिक्रियाओं की सूची बनाना देखें. उपयोगकर्ता की पुष्टि ज़रूरी है.

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

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".

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

अगर आपकी क्वेरी में 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

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