MCP Tools Reference: gmailmcp.googleapis.com

כלי: list_drafts

הפונקציה מחזירה רשימה של טיוטות אימייל מחשבון Gmail של המשתמש המאומת.

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

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

בקשת Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--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 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 כדי לאחזר את דף התוצאות הבא. אם משאירים את השדה ריק, המערכת מאחזרת את הדף הראשון.

שדה איחוד _query.

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

string

אופציונלי. מחרוזת שאילתה לסינון הטיוטות, באמצעות אותו פורמט כמו בסרגל החיפוש של חיפוש ב-Gmail. אם לא מציינים את השדה הזה, מוצגות כל הטיוטות (לא כולל ספאם ואשפה כברירת מחדל). מילות מפתח: from: – הודעות משולח ספציפי. to: – הודעות שנשלחו לנמען ספציפי. subject: – הודעות עם מילים ספציפיות בנושא. - הודעות שמכילות מילים ספציפיות בגוף ההודעה או בנושא. is:unread - הודעות שלא נקראו. is:starred - הודעות שמסומנות בכוכב. has:attachment - הודעות עם קבצים מצורפים. after:YYYY/MM/DD – הודעות שנשלחו אחרי תאריך מסוים. before:YYYY/MM/DD – הודעות שנשלחו לפני תאריך מסוים. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

סכימת פלט

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

ListDraftsResponse

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

object (Draft)

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

string

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

טיוטה

ייצוג 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).

הערות על כלי

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