MCP Tools Reference: chatmcp.googleapis.com

ابزار: list_messages

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

مثال زیر نحوه استفاده از curl برای فراخوانی ابزار list_messages 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": "list_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست پیام برای RPC مربوط به ListMessages.

درخواست لیستچتپیام‌ها

نمایش JSON 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
فیلدها
conversationId

string

الزامی. شناسه مکالمه. یک مکالمه می‌تواند با فاصله، پیام مستقیم (DM) یا پیام مستقیم/چت گروهی باشد. قالب: فاصله/{space}

threadId

string

اختیاری. شناسه‌ی یک رشته‌ی خاص در مکالمه. در صورت ارائه، فقط پیام‌های این رشته بازگردانده می‌شوند. در صورت حذف، پیام‌های تمام رشته‌های مکالمه در نظر گرفته می‌شوند. قالب: فاصله‌ها/{space}/threads/{thread}

pageSize

integer

اختیاری. حداکثر تعداد پیام‌هایی که باید برگردانده شود. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، پیش‌فرض 20 است. حداکثر مقدار مجاز 50 است.

pageToken

string

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

startTime

string

اختیاری. مهر زمانی ISO 8601 برای فیلتر کردن پیام‌ها. فقط پیام‌هایی که پس از این زمان ایجاد می‌شوند، بازگردانده می‌شوند.

endTime

string

اختیاری. مهر زمانی ISO 8601 برای فیلتر کردن پیام‌ها. فقط پیام‌هایی که قبل از این زمان ایجاد شده‌اند، بازگردانده می‌شوند.

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

پیام پاسخ برای ListMessages RPC.

پاسخ لیستچتپیام‌ها

نمایش JSON 
{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}
فیلدها
messages[]

object ( ChatMessage )

فهرست پیام‌های بازیابی‌شده، به ترتیب زمانی معکوس (جدیدترین‌ها اول).

nextPageToken

string

یک توکن، که می‌تواند به عنوان page_token در یک ListMessagesRequest بعدی برای بازیابی صفحه بعدی پیام‌ها ارسال شود. اگر این فیلد خالی باشد، صفحات بیشتری وجود ندارد.

چتپیام

نمایش JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
فیلدها
messageId

string

نام منبع پیام. قالب: فاصله‌ها/{فاصله}/پیام‌ها/{پیام}

threadId

string

رشته‌ای که این پیام به آن تعلق دارد. اگر پیام رشته‌بندی نشده باشد، این قسمت خالی خواهد بود. قالب: space/{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

نام منبع یک کاربر چت. فرمت: users/{user}.

displayName

string

نام نمایشی کاربر چت.

email

string

آدرس ایمیل کاربر. این فیلد فقط زمانی پر می‌شود که نوع کاربر HUMAN باشد.

userType

enum ( UserType )

نوع کاربر.

فراداده پیوست چت

نمایش JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
فیلدها
attachmentId

string

نام منبع پیوست. قالب: space/{space}/messages/{message}/attachments/{attachment}.

filename

string

نام فایل پیوست.

mimeType

string

نوع محتوا (نوع MIME).

source

enum ( Source )

منبع پیوست.

خلاصه واکنش

نمایش JSON 
{
  "emoji": string,
  "count": integer
}
فیلدها
emoji

string

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

count

integer

تعداد کل واکنش‌ها با استفاده از ایموجی مرتبط.

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

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