MCP Tools Reference: chatmcp.googleapis.com

ابزار: search_conversations

مکالمات گوگل چت را بر اساس نام نمایشی جستجو می‌کند.

اگر فقط شرکت‌کنندگان ارائه شده باشند، این ابزار پیام‌های مستقیم ۱:۱ (اگر یک شرکت‌کننده ارائه شده باشد) یا چت‌های گروهی (اگر چندین شرکت‌کننده ارائه شده باشد) را که شامل شرکت‌کنندگان مشخص شده و کاربر تماس‌گیرنده هستند، پیدا می‌کند.

اگر فقط یک پرس‌وجو ارائه شده باشد، این ابزار مکالماتی را جستجو می‌کند که پرس‌وجو در آنها یک زیررشته‌ی غیرحساس به حروف بزرگ و کوچک از نام نمایشی مکالمه باشد.

اگر هم شرکت‌کنندگان و هم پرس‌وجو ارائه شده باشند، این ابزار مکالمات را بر اساس شرکت‌کنندگان پیدا کرده و سپس آنها را بر اساس نام نمایشی فیلتر می‌کند.

اگر نه شرکت‌کننده‌ای ارائه شود و نه پرسشی، این ابزار تمام مکالماتی را که کاربر تماس‌گیرنده عضوی از آن است، فهرست می‌کند.

این ابزار فقط مکالماتی را فهرست می‌کند که کاربر تماس‌گیرنده عضوی از آنها است.

مهم: خالی بودن لیست «گفتگوها» به این معنی نیست که در کل هیچ نتیجه‌ای وجود ندارد. اگر «next_page_token» وجود داشته باشد، صفحات بیشتری قابل بازیابی هستند. اگر لیست خالی اما «next_page_token» دریافت کردید، از کاربر بپرسید که آیا باید جستجو را ادامه دهد یا خیر.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار search_conversations MCP را نشان می‌دهد.

درخواست کرل 
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.

جستجوگفتگوهادرخواست

نمایش JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
فیلدها
spaceNameQuery

string

اختیاری. متنی که قرار است در فضای نام نمایش داده شده جستجو شود.

pageSize

integer

اختیاری. حداکثر تعداد فاصله برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰۰ فاصله برگردانده می‌شود. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ محدود می‌شوند.

pageToken

string

اختیاری. یک توکن صفحه، که از فراخوانی قبلی search_conversations دریافت شده است. این را برای بازیابی صفحه بعدی ارائه دهید.

participants[]

string

اختیاری. فهرست آدرس‌های ایمیل شرکت‌کنندگان برای فیلتر کردن مکالمات، به جز تماس‌گیرنده.

طرحواره خروجی

پیام پاسخ برای RPC مربوط به FindConversations.

جستجوگفتگوهاپاسخ

نمایش 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

شناسه‌ی مکالمه (مثلاً «فاصله‌ها/AAAAAAAAA»).

displayName

string

نام نمایشی مکالمه.

conversationType

enum ( ConversationType )

نوع مکالمه (DIRECT_MESSAGE، GROUP_CHAT یا NAMED_SPACE).

lastActiveTimestamp

string ( Timestamp format)

آخرین زمان فعال بودن مکالمه در قالب ISO 8601.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌