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/v1' \
--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
}'

इनपुट स्कीमा

फ़िल्टर का इस्तेमाल करके, Google Chat में हुई बातचीत खोजने का अनुरोध.

SearchConversationsRequest

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

string

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

integer

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

string

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

string

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

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

जवाब में, मिलती-जुलती बातचीत की सूची शामिल होती है.

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 के बीच होना चाहिए.

ConversationType

इससे बातचीत के टाइप के बारे में पता चलता है.

Enums
CONVERSATION_TYPE_UNSPECIFIED नहीं बताया गया है
NAMED_SPACE नाम वाला स्पेस.
GROUP_CHAT तीन या उससे ज़्यादा लोगों के बीच होने वाली ग्रुप चैट.
DIRECT_MESSAGE दो लोगों के बीच या किसी व्यक्ति और Chat ऐप्लिकेशन के बीच हुई बातचीत.

टूल एनोटेशन

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