MCP Tools Reference: gmailmcp.googleapis.com

ابزار: label_message

یک یا چند برچسب به یک پیام خاص در حساب Gmail کاربر احراز هویت شده اضافه می‌کند.

برای یافتن شناسه پیام، از ابزارهایی مانند search_threads یا get_thread استفاده کنید. اگر از شناسه برچسب کاربر مطمئن نیستید، ابتدا از ابزار list_labels برای کشف برچسب‌های موجود و شناسه‌های آنها استفاده کنید.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار label_message MCP را نشان می‌دهد.

درخواست کرل 
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": "label_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست پیام برای LabelMessage RPC.

درخواست پیام برچسب

نمایش JSON 
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
فیلدها
messageId

string

الزامی. شناسه‌ی پیامی که برچسب‌ها به آن اضافه می‌شوند.

labelIds[]

string

الزامی. شناسه‌های برچسب‌هایی که باید اضافه شوند. می‌توانند شناسه برچسب سیستمی (مثلاً «صندوق ورودی»، «سطل زباله»، «هرزنامه»، «ستاره‌دار»، «خوانده نشده»، «مهم») یا شناسه برچسب تعریف‌شده توسط کاربر باشند. این ابزار label_ids می‌پذیرد و نام برچسب را نمی‌پذیرد. از ابزار list_labels برای دریافت شناسه برچسب مربوطه به نام نمایشی برای برچسب‌های تعریف‌شده توسط کاربر استفاده کنید.

طرحواره خروجی

پیام پاسخ برای LabelMessage RPC.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ❌