MCP Tools Reference: chatmcp.googleapis.com

כלי: `list_messages`

שליפת הודעות משיחה ספציפית ב-Google Chat (מרחב, צ'אט ישיר או צ'אט קבוצתי). אפשר לסנן לפי שרשור, טווח זמן ומספר הודעות. בנוסף, אפשר לאחזר את הדף הבא של ההודעות כדי לקבל הקשר נוסף. הודעות פרטיות (הודעות שגלויות רק למשתמש אחד) מסוננות.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ list_messages.

בקשת 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
}'

סכימת קלט

הודעת בקשה לקריאה לשירות מרוחק (RPC) של ListMessages.

ListChatMessagesRequest

ייצוג JSON
{ "conversationId": string, "threadId": string, "pageSize": integer, "pageToken": string, "startTime": string, "endTime": string }

שדות
`conversationId`	`string` חובה. המזהה של השיחה. שיחה יכולה להיות מרחב, צ'אט ישיר או צ'אט קבוצתי. פורמט: רווחים/{רווח}
`threadId`	`string` אופציונלי. המזהה של שרשור ספציפי בשיחה. אם מציינים את השרשור, יוחזרו רק הודעות מהשרשור הזה. אם לא מציינים שרשור, המערכת מתייחסת להודעות מכל השרשורים בשיחה. פורמט: spaces/{space}/threads/{thread}
`pageSize`	`integer` אופציונלי. מספר ההודעות המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, ברירת המחדל היא 20. הערך המקסימלי המותר הוא 50.
`pageToken`	`string` אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של list_messages. צריך להזין את הטוקן כדי לאחזר את הדף הבא.
`startTime`	`string` אופציונלי. חותמת זמן בפורמט ISO 8601 לסינון הודעות. רק הודעות שנוצרו אחרי השעה הזו יוחזרו.
`endTime`	`string` אופציונלי. חותמת זמן בפורמט ISO 8601 לסינון הודעות. רק הודעות שנוצרו לפני השעה הזו יוחזרו.

סכימת פלט

הודעת התגובה לקריאה לשירות מרוחק (RPC) של 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` מחרוזת ה-Unicode של האמוג'י או שם האמוג'י בהתאמה אישית.
`count`	`integer` המספר הכולל של התגובות באמצעות האמוג'י המשויך.

emoji

string

מחרוזת ה-Unicode של האמוג'י או שם האמוג'י בהתאמה אישית.

count

integer

המספר הכולל של התגובות באמצעות האמוג'י המשויך.

הערות על כלי

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌