MCP Tools Reference: chatmcp.googleapis.com

टूल: search_conversations

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

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

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

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

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

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

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

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

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
}'

इनपुट स्कीमा

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

SearchConversationsRequest

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

string

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

integer

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

string

ज़रूरी नहीं. पेज टोकन, जो search_conversations के पिछले कॉल से मिला है. अगला पेज पाने के लिए, इसे उपलब्ध कराएं.
participants[]

string

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

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

FindConversations आरपीसी के लिए जवाब मैसेज.

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)

ISO 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 और 999,999,999 के बीच होना चाहिए. इसमें ये वैल्यू भी शामिल हैं.

ConversationType

बातचीत का टाइप तय करता है.

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

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

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ✅ | रीड ओनली हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌