MCP Tools Reference: chatmcp.googleapis.com

टूल: list_messages

इससे, Google Chat में हुई किसी बातचीत (स्पेस, डायरेक्ट मैसेज (डीएम) या ग्रुप डीएम) के मैसेज वापस पाए जा सकते हैं. इससे, थ्रेड, समयसीमा, और मैसेज की संख्या के हिसाब से फ़िल्टर किया जा सकता है. इसके अलावा, ज़्यादा जानकारी पाने के लिए, मैसेज का अगला पेज भी वापस पाया जा सकता है. निजी मैसेज (सिर्फ़ एक उपयोगकर्ता को दिखने वाले मैसेज) फ़िल्टर कर दिए जाते हैं.

यहां दिए गए सैंपल में, list_messages MCP टूल को शुरू करने के लिए, curl का इस्तेमाल करने का तरीका बताया गया है.

Curl का अनुरोध 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

ListMessages RPC के लिए अनुरोध मैसेज.

ListChatMessagesRequest

JSON के काेड में दिखाना 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
फ़ील्ड
conversationId

string

ज़रूरी है. यह बातचीत की आईडी है. कोई बातचीत, स्पेस, डायरेक्ट मैसेज (डीएम) या ग्रुप डीएम/Chat हो सकती है. फ़ॉर्मैट: spaces/{space}
threadId

string

ज़रूरी नहीं. यह बातचीत में मौजूद किसी खास थ्रेड की आईडी है. अगर यह आईडी दी जाती है, तो सिर्फ़ इस थ्रेड के मैसेज दिखाए जाएंगे. अगर यह आईडी नहीं दी जाती है, तो बातचीत में मौजूद सभी थ्रेड के मैसेज दिखाए जाएंगे. फ़ॉर्मैट: spaces/{space}/threads/{thread}
pageSize

integer

ज़रूरी नहीं. यह मैसेज की वह ज़्यादा से ज़्यादा संख्या है जो दिखाई जा सकती है. ऐसा हो सकता है कि सेवा, इस वैल्यू से कम मैसेज दिखाए. अगर यह वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से 20 मैसेज दिखाए जाते हैं. ज़्यादा से ज़्यादा 50 मैसेज दिखाए जा सकते हैं.
pageToken

string

ज़रूरी नहीं. यह पेज टोकन है, जो list_messages के पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह टोकन दें.
startTime

string

ज़रूरी नहीं. यह ISO 8601 फ़ॉर्मैट में टाइमस्टैंप है. इसका इस्तेमाल, मैसेज फ़िल्टर करने के लिए किया जाता है. सिर्फ़ इस समय के बाद बनाए गए मैसेज दिखाए जाएंगे.
endTime

string

ज़रूरी नहीं. यह ISO 8601 फ़ॉर्मैट में टाइमस्टैंप है. इसका इस्तेमाल, मैसेज फ़िल्टर करने के लिए किया जाता है. सिर्फ़ इस समय से पहले बनाए गए मैसेज दिखाए जाएंगे.

आउटपुट स्कीमा

ListMessages RPC के लिए जवाब मैसेज.

ListChatMessagesResponse

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

object (ChatMessage)

यहां वापस पाए गए मैसेज की सूची दी गई है. ये मैसेज, समय के हिसाब से उल्टे क्रम में दिखते हैं. इसका मतलब है कि सबसे नया मैसेज सबसे ऊपर दिखता है.
nextPageToken

string

यह एक टोकन है. इसे ListMessagesRequest में page_token के तौर पर भेजकर, मैसेज का अगला पेज पाया जा सकता है. अगर यह फ़ील्ड खाली है, तो इसका मतलब है कि कोई और पेज नहीं है.

ChatMessage

JSON के काेड में दिखाना 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
फ़ील्ड
messageId

string

यह मैसेज का संसाधन नाम है. फ़ॉर्मैट: spaces/{space}/messages/{message}
threadId

string

यह उस थ्रेड की आईडी है जिससे यह मैसेज जुड़ा है. अगर मैसेज किसी थ्रेड का हिस्सा नहीं है, तो यह फ़ील्ड खाली होगा. फ़ॉर्मैट: spaces/{space}/threads/{thread}
plaintextBody

string

यह मैसेज का प्लेन टेक्स्ट है.
sender

object (User)

यह मैसेज भेजने वाले व्यक्ति की जानकारी है.
createTime

string

सिर्फ़ आउटपुट के लिए. यह वह टाइमस्टैंप है जब मैसेज बनाया गया था.
threadedReply

boolean

इससे पता चलता है कि मैसेज, थ्रेड का जवाब है या नहीं.
attachments[]

object (ChatAttachmentMetadata)

यह मैसेज में शामिल अटैचमेंट की जानकारी है.
reactionSummaries[]

object (ReactionSummary)

यह मैसेज में शामिल इमोजी से दी गई प्रतिक्रियाओं की खास जानकारी है.

उपयोगकर्ता

JSON के काेड में दिखाना 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
फ़ील्ड
userId

string

यह Chat इस्तेमाल करने वाले व्यक्ति का संसाधन नाम है. फ़ॉर्मैट: users/{user}.
displayName

string

यह Chat इस्तेमाल करने वाले व्यक्ति का डिसप्ले नेम है.
email

string

यह उपयोगकर्ता का ईमेल पता है. यह फ़ील्ड सिर्फ़ तब पॉप्युलेट होता है, जब उपयोगकर्ता का टाइप HUMAN होता है.
userType

enum (UserType)

यह उपयोगकर्ता का टाइप है.

ChatAttachmentMetadata

JSON के काेड में दिखाना 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
फ़ील्ड
attachmentId

string

यह अटैचमेंट का संसाधन नाम है. फ़ॉर्मैट: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

यह अटैचमेंट का नाम है.
mimeType

string

यह कॉन्टेंट का टाइप (MIME टाइप) है.
source

enum (Source)

यह अटैचमेंट का सोर्स है.

ReactionSummary

JSON के काेड में दिखाना 
{
  "emoji": string,
  "count": integer
}
फ़ील्ड
emoji

string

यह इमोजी का यूनिकोड स्ट्रिंग या पसंद के मुताबिक बनाए गए इमोजी का नाम है.
count

integer

यह उस इमोजी का इस्तेमाल करके दी गई प्रतिक्रियाओं की कुल संख्या है.

टूल के एनोटेशन

डेटा मिटाने की सुविधा: ❌ | एक ही कार्रवाई को बार-बार करने की सुविधा: ✅ | सिर्फ़ पढ़ने की सुविधा: ✅ | सभी के लिए उपलब्ध होने की सुविधा: ❌