MCP Tools Reference: chatmcp.googleapis.com

टूल: search_conversations

यह डिसप्ले नेम के हिसाब से, Google Chat पर हुई बातचीत खोजता है.

अगर सिर्फ़ हिस्सा लेने वाले लोगों की जानकारी दी जाती है, तो यह टूल एक-दूसरे को भेजे गए डायरेक्ट मैसेज (अगर हिस्सा लेने वाले व्यक्ति की जानकारी दी गई है) या ग्रुप चैट (अगर हिस्सा लेने वाले कई लोगों की जानकारी दी गई है) ढूंढता है. इनमें हिस्सा लेने वाले लोग और कॉल करने वाला व्यक्ति शामिल होता है.

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

अगर दोनों, यानी कि मीटिंग में शामिल लोगों और क्वेरी की जानकारी दी जाती है, तो यह टूल मीटिंग में शामिल लोगों की बातचीत ढूंढता है. इसके बाद, उन्हें डिसप्ले नेम के हिसाब से फ़िल्टर करता है.

अगर न तो हिस्सा लेने वाले लोगों की जानकारी दी जाती है और न ही क्वेरी, तो यह टूल उन सभी बातचीत की सूची दिखाता है जिनमें कॉल करने वाला व्यक्ति सदस्य है.

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

अहम जानकारी: 'बातचीत' की खाली सूची का मतलब यह नहीं है कि अब कोई और नतीजा नहीं है. अगर 'next_page_token' मौजूद है, तो ज़्यादा पेज फ़ेच किए जा सकते हैं. अगर आपको खाली सूची मिलती है, लेकिन 'next_page_token' मिलता है, तो उपयोगकर्ता से पूछें कि क्या आपको खोज जारी रखनी चाहिए.

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

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": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

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

SearchConversationsRequest

JSON के काेड में दिखाना 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
फ़ील्ड
spaceNameQuery

string

ज़रूरी नहीं. स्पेस के डिसप्ले नेम में खोजने के लिए टेक्स्ट.
pageSize

integer

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

string

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

string

ज़रूरी नहीं. बातचीत को फ़िल्टर करने के लिए, कॉल में हिस्सा लेने वाले लोगों के ईमेल पतों की सूची. इसमें कॉल करने वाले का ईमेल पता शामिल नहीं है.

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

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

SearchConversationsResponse

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

object (Conversation)

खोज के लिए इस्तेमाल किए गए शब्दों से मेल खाने वाले बातचीत के ऑब्जेक्ट की सूची.
nextPageToken

string

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

बातचीत

JSON के काेड में दिखाना 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
फ़ील्ड
conversationId

string

बातचीत का आईडी (उदाहरण के लिए, "spaces/AAAAAAAAA").
displayName

string

बातचीत का डिसप्ले नेम.
conversationType

enum (ConversationType)

बातचीत का टाइप (DIRECT_MESSAGE, GROUP_CHAT या NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

आईएसओ 8601 फ़ॉर्मैट में, बातचीत में आखिरी बार गतिविधि होने का समय.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

टाइमस्टैम्प

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

string (int64 format)

यह Unix epoch 1970-01-01T00:00:00Z के बाद से यूटीसी समय के सेकंड को दिखाता है. यह -62135596800 और 253402300799 के बीच होना चाहिए. इसमें ये दोनों वैल्यू भी शामिल हैं. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच की वैल्यू के बराबर होता है.
nanos

integer

नैनोसेकंड रिज़ॉल्यूशन पर, सेकंड के नॉन-नेगेटिव फ़्रैक्शन. यह फ़ील्ड, अवधि का नैनोसेकंड वाला हिस्सा है. यह सेकंड का विकल्प नहीं है. भिन्नात्मक वैल्यू वाली नेगेटिव सेकंड वैल्यू में, नैनोसेकंड की नॉन-नेगेटिव वैल्यू होनी चाहिए. यह 0 और 99,99,99,999 के बीच होना चाहिए.

टूल एनोटेशन

बदलाव करने से जुड़ी जानकारी: ❌ | एक ही बार लागू होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌