MCP Tools Reference: chatmcp.googleapis.com

כלי: list_messages

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

בדוגמת הקוד הבאה מוצג שימוש בפקודה curl כדי להפעיל את הכלי list_messages MCP.

בקשת Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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
}'

סכימת הקלט

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. אם משתמשים בערך גבוה מ-50, הוא משתנה אוטומטית ל-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

NECESSARY. The thread this message belongs to. השדה הזה יהיה ריק אם ההודעה לא שייכת לשרשור. פורמט: 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

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

integer

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

UserType

הסוג של משתמש Google Chat.

טיפוסים בני מנייה (enum)
USER_TYPE_UNSPECIFIED לא צוין.
HUMAN משתמש אנושי.
APP משתמש באפליקציה.

מקור

המקור של הקובץ המצורף.

טיפוסים בני מנייה (enum)
SOURCE_UNSPECIFIED שמורות.
DRIVE_FILE הקובץ הוא קובץ Google Drive.
UPLOADED_CONTENT הקובץ יועלה ל-Chat.

הערות על כלים

הערות על כלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כאל רמזים לא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש הנחיה לאישור.

בנוסף למחרוזת הכותרת, מוגדרים הרמזים הבוליאניים הבאים:

  • ‫readOnlyHint: אם הערך הוא true, הכלי לא משנה את הסביבה שלו. ברירת מחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא false, הכלי יכול לבצע רק פעולות של הוספה. ברירת מחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת מחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול ליצור אינטראקציה עם 'עולם פתוח' של ישויות חיצוניות. אם הערך הוא false, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly