MCP Tools Reference: chatmcp.googleapis.com

الأداة: `list_messages`

يستردّ هذا الإجراء الرسائل من محادثة محدّدة في Google Chat (مساحة أو رسالة مباشرة أو رسالة مباشرة جماعية). تتيح هذه السمة إجراء فلترة حسب سلسلة المحادثات والنطاق الزمني وعدد الرسائل. بالإضافة إلى ذلك، يمكن استرداد الصفحة التالية من الرسائل للسماح بعرض المزيد من السياق. يتم استبعاد الرسائل الخاصة (الرسائل التي يمكن لمستخدم واحد فقط الاطّلاع عليها).

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة list_messages MCP.

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

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

مخطط الإدخال

طلب رسالة لإجراء ListMessages RPC.

ListChatMessagesRequest

تمثيل JSON
{ "conversationId": string, "threadId": string, "pageSize": integer, "pageToken": string, "startTime": string, "endTime": string }

الحقول
`conversationId`	`string` الحقل مطلوب. رقم تعريف المحادثة. يمكن أن تكون المحادثة مساحة أو رسالة مباشرة أو رسالة جماعية مباشرة أو محادثة جماعية. التنسيق: spaces/{space}
`threadId`	`string` اختياريّ. معرّف سلسلة محادثات معيّنة ضمن المحادثة في حال توفُّرها، سيتم عرض الرسائل من سلسلة المحادثات هذه فقط. في حال عدم تحديدها، يتم أخذ الرسائل من جميع سلاسل المحادثات في المحادثة في الاعتبار. التنسيق: spaces/{space}/threads/{thread}
`pageSize`	`integer` اختياريّ. الحدّ الأقصى لعدد الرسائل المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، تكون القيمة التلقائية 20. الحدّ الأقصى المسموح به هو 50.
`pageToken`	`string` اختياريّ. رمز مميّز للصفحة تم استلامه من طلب list_messages سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.
`startTime`	`string` اختياريّ. طابع زمني بتنسيق ISO 8601 لفلترة الرسائل. ولن يتم عرض سوى الرسائل التي تم إنشاؤها بعد هذا الوقت.
`endTime`	`string` اختياريّ. طابع زمني بتنسيق ISO 8601 لفلترة الرسائل. ولن يتم عرض سوى الرسائل التي تم إنشاؤها قبل هذا الوقت.

مخطط النتائج

رسالة الردّ على إجراء ListMessages عن بُعد.

ListChatMessagesResponse

تمثيل JSON
{ "messages": [ { object (`ChatMessage`) } ], "nextPageToken": string }

الحقول

الحقول
`messages[]`	`object (ChatMessage)` قائمة بالرسائل التي تم استردادها، بترتيب زمني عكسي (الأحدث أولاً).
`nextPageToken`	`string` رمز مميز يمكن إرساله كـ `page_token` في `ListMessagesRequest` لاحق لاسترداد الصفحة التالية من الرسائل إذا كان هذا الحقل فارغًا، يعني ذلك أنّه لم يعُد هناك صفحات أخرى.

messages[]

object (ChatMessage)

قائمة بالرسائل التي تم استردادها، بترتيب زمني عكسي (الأحدث أولاً).

nextPageToken

string

رمز مميز يمكن إرساله كـ page_token في ListMessagesRequest لاحق لاسترداد الصفحة التالية من الرسائل إذا كان هذا الحقل فارغًا، يعني ذلك أنّه لم يعُد هناك صفحات أخرى.

ChatMessage

تمثيل JSON

تمثيل JSON
{ "messageId": string, "threadId": string, "plaintextBody": string, "sender": { object (`User`) }, "createTime": string, "threadedReply": boolean, "attachments": [ { object (`ChatAttachmentMetadata`) } ], "reactionSummaries": [ { object (`ReactionSummary`) } ] }

{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}

الحقول
`messageId`	`string` اسم مورد الرسالة التنسيق: spaces/{space}/messages/{message}
`threadId`	`string` سلسلة المحادثات التي تنتمي إليها هذه الرسالة سيكون هذا الحقل فارغًا إذا كانت الرسالة غير مرتبطة بسلسلة محادثات. التنسيق: spaces/{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` اسم المورد لمستخدم Chat التنسيق: users/{user}.
`displayName`	`string` الاسم المعروض لمستخدم Chat
`email`	`string` عنوان البريد الإلكتروني للمستخدم لا تتم تعبئة هذا الحقل إلا عندما يكون نوع المستخدم HUMAN.
`userType`	`enum (UserType)` نوع المستخدم

ChatAttachmentMetadata

تمثيل JSON
{ "attachmentId": string, "filename": string, "mimeType": string, "source": enum (`Source`) }

الحقول
`attachmentId`	`string` اسم مصدر المرفق التنسيق: spaces/{space}/messages/{message}/attachments/{attachment}.
`filename`	`string` اسم المرفق
`mimeType`	`string` نوع المحتوى (نوع MIME)
`source`	`enum (Source)` مصدر المرفق

تمثيل JSON
{ "emoji": string, "count": integer }

الحقول

الحقول
`emoji`	`string` سلسلة يونيكود الإيموجي أو اسم الإيموجي المخصّص
`count`	`integer` تمثّل هذه السمة إجمالي عدد التفاعلات باستخدام الإيموجي المرتبط.

emoji

string

سلسلة يونيكود الإيموجي أو اسم الإيموجي المخصّص

count

integer

تمثّل هذه السمة إجمالي عدد التفاعلات باستخدام الإيموجي المرتبط.

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌