MCP Tools Reference: chatmcp.googleapis.com

الأداة: list_messages

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

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

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

مخطط الإدخال

طلب إدراج الرسائل من محادثة معيّنة في Google Chat

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 لفلترة الرسائل. سيتم عرض الرسائل التي تم إنشاؤها قبل هذا الوقت فقط.

مخطط النتائج

استجابة تحتوي على قائمة بالرسائل من المحادثة المطلوبة

ListChatMessagesResponse

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

object (ChatMessage)

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

string

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

ChatMessage

تمثيل JSON 
{
  "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

نص الرسالة باستخدام تنسيق Markdown
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)

مصدر المرفق

ReactionSummary

تمثيل JSON 
{
  "emoji": string,
  "count": integer
}
الحقول
emoji

string

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

integer

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

UserType

نوع مستخدم Google Chat

عمليات التعداد
USER_TYPE_UNSPECIFIED غير محدد
HUMAN مستخدم بشري
APP مستخدم التطبيق

المصدر

مصدر المرفق

عمليات التعداد
SOURCE_UNSPECIFIED محجوز
DRIVE_FILE الملف هو ملف Google Drive.
UPLOADED_CONTENT يتم تحميل الملف إلى Chat.

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

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