MCP Tools Reference: gmailmcp.googleapis.com

כלי: unlabel_message

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

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

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

סכימת הקלט

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

UnlabelMessageRequest

ייצוג ב-JSON
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
שדות
messageId

string

חובה. המזהה של ההודעה שרוצים להסיר ממנה את התוויות.

labelIds[]

string

חובה. המזהים של התוויות שרוצים להסיר. יכול להיות מזהה של תווית מערכת (למשל, 'INBOX',‏ 'TRASH',‏ 'SPAM',‏ 'STARRED',‏ 'UNREAD',‏ 'IMPORTANT') או מזהה של תווית שהוגדרה על ידי המשתמש. הכלי מקבל label_ids ולא שמות של תוויות. כדי לקבל את מזהה התווית שמתאים לשם תצוגה של תוויות שהוגדרו על ידי המשתמש, משתמשים בכלי list_labels.

סכימת פלט

הודעת תגובה ל-RPC של UnlabelMessage.

הערות על כלי

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