MCP Tools Reference: gmailmcp.googleapis.com

כלי: list_drafts

מציג רשימה של טיוטות אימייל מחשבון Gmail של המשתמש המאומת.

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

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

בקשת 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": "list_drafts",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

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

ListDraftsRequest

ייצוג ב-JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
שדות

שדה איחוד _page_size.

הערך _page_size יכול להיות רק אחד מהבאים:
pageSize

integer

אופציונלי. מספר הטיוטות המקסימלי שיוחזרו. אם לא מציינים ערך, ברירת המחדל היא 20. הערך המקסימלי המותר הוא 50.

שדה איחוד _page_token.

הערך _page_token יכול להיות רק אחד מהבאים:
pageToken

string

אופציונלי. טוקן שהתקבל מקריאה קודמת של list_drafts כדי לאחזר את דף התוצאות הבא. אם משאירים את השדה ריק, המערכת מאחזרת את הדף הראשון. הפרמטר הזה משמש בעיקר להוספת מספור לדפים, כדי להמשיך לאחזר תוצאות מהמקום שבו הסתיים הקריאה הקודמת ל-ListDraft, במיוחד כשמספר הטיוטות שתואמות לשאילתה חורג מהמגבלה של page_size.

שדה איחוד _query.

הערך _query יכול להיות רק אחד מהבאים:
query

string

דוגמאות: "subject:OneMCP Update" "from:gduser1@workspacesamples.dev" "to:gduser2@workspacesamples.dev AND newer_than:7d" "project proposal has:attachment" "is:unread"

תו רווח או קו מפריד (-) מפרידים את המספר, ואילו נקודה (.) תהיה נקודה עשרונית. לדוגמה, הביטוי 01.2047-100 נחשב כשני מספרים: 01.2047 ו-100.

הערה: כדי לוודא שכל הטיוטות של השאילתה יוחזרו, אפשר להשתמש בעימוד של התוצאות. לשם כך, צריך להפעיל את הכלי שוב ושוב עד שהתשובה תכיל רשימה ריקה של טיוטות.

סכימת פלט

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

ListDraftsResponse

ייצוג ב-JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
שדות
drafts[]

object (Draft)

רשימת טיוטות.
nextPageToken

string

טוקן שאפשר להשתמש בו בקריאה הבאה כדי לאחזר את הדף הבא של טיוטות. אם מספר הטיוטות שתואמות לשאילתה חורג מהמגבלה של page_size, התשובה תכיל next_page_token. כדי לאחזר את הדף הבא של התוצאות, מעבירים את האסימון הזה בשדה page_token של ListDraftsRequest הבא.

טיוטה

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

string

המזהה הייחודי של משאב הטיוטה.
subject

string

שורת הנושא של הטיוטה.
threadId

string

המזהה של השרשור שהטיוטה שייכת אליו.
toRecipients[]

string

רשימה של כתובות אימייל של נמענים בשדה 'אל' שחולצו מהכותרות.
ccRecipients[]

string

רשימה של כתובות אימייל של נמענים בשדה 'עותק' שחולצו מהכותרות.
bccRecipients[]

string

רשימה של כתובות אימייל של נמענים בשדה 'עותק מוסתר' שחולצו מהכותרות.
plaintextBody

string

תוכן הגוף בטקסט פשוט, אם זמין.
date

string

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

הערות על כלי

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