MCP Tools Reference: gmailmcp.googleapis.com

ابزار: label_thread

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

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

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

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

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

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

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

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

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

string

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

labelIds[]

string

الزامی. شناسه‌های منحصر به فرد برچسب‌هایی که باید اضافه شوند. می‌تواند شناسه برچسب سیستم (مثلاً «INBOX»، «TRASH»، «SPAM»، «STARRED»، «UNREAD») یا شناسه برچسب تعریف شده توسط کاربر باشد.

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

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

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

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