MCP Tools Reference: gmailmcp.googleapis.com

ابزار: label_thread

برچسب‌ها را به کل یک رشته گفتگو در حساب جیمیل کاربر احراز هویت شده اضافه می‌کند. این عملیات بر تمام پیام‌های فعلی در رشته گفتگو و هر پیام بعدی که به آن اضافه شود، تأثیر می‌گذارد.

اگر از شناسه‌ی رشته مطمئن نیستید، ابتدا از ابزار search_threads استفاده کنید.

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

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار label_thread 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_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

درخواست موضوع برچسب

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

string

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

labelIds[]

string

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

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

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

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

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