MCP Tools Reference: gmailmcp.googleapis.com

כלי: get_thread

אחזור שרשור אימיילים ספציפי מחשבון Gmail של המשתמש המאומת, כולל רשימה של ההודעות בשרשור.

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

בקשת Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

הודעת בקשה ל-RPC של GetThread.

GetThreadRequest

ייצוג ב-JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
שדות
threadId

string

חובה. המזהה הייחודי של השרשור שיש לאחזר.
messageFormat

enum (MessageFormat)

אופציונלי. מציין את הפורמט של ההודעות שמוחזרות בשרשור. ברירת המחדל היא FULL_CONTENT. הערה: אם אתם צריכים את תוכן הגוף או קבצים מצורפים, השתמשו ב-FULL_CONTENT. כשמשתמשים בערך MINIMAL, השדות plaintext_body ו-attachment_ids לא יאוכלסו. אם אתם לא בטוחים באיזה פורמט להשתמש, אתם יכולים להסתמך על התנהגות ברירת המחדל באמצעות FULL_CONTENT.

MessageFormat

סוג הנתונים Enum שקובע את רמת הפירוט של ההודעות בשרשור.

טיפוסים בני מנייה (enum)
MESSAGE_FORMAT_UNSPECIFIED ברירת המחדל היא FULL_CONTENT.
MINIMAL הפונקציה מחזירה קטעי הודעות וכותרות מפתח (נושא, מאת, אל, עותק, תאריך).
FULL_CONTENT מחזירה את כל המידע ב-MINIMAL בתוספת התוכן המלא של כל הודעה.

סכימת פלט

שרשור שמכיל רשימה של הודעות.

חוט תפירה

ייצוג ב-JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
שדות
id

string

המזהה הייחודי של השרשור.
messages[]

object (Message)

רשימת ההודעות בשרשור, מסודרות בסדר כרונולוגי.

שליחת הודעה

ייצוג ב-JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
שדות
id

string

המזהה הייחודי של ההודעה.
snippet

string

קטע מגוף ההודעה.
subject

string

נושא ההודעה שחולץ מהכותרות:
sender

string

כתובת האימייל של השולח.
toRecipients[]

string

כתובות האימייל של הנמענים.
ccRecipients[]

string

כתובות אימייל של נמענים בשדה 'עותק'.
date

string

התאריך של ההודעה בפורמט ISO 8601‏ (YYYY-MM-DD).
plaintextBody

string

תוכן מלא של גוף ההודעה, מאוכלס רק אם MessageFormat היה FULL_CONTENT.
attachmentIds[]

string

פלט בלבד. מזהי הקבצים המצורפים, מאוכלסים רק אם MessageFormat היה FULL_CONTENT.

הערות על כלי

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