MCP Tools Reference: gmailmcp.googleapis.com

ابزار: label_thread

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

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

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

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

درخواست کرل 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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.

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

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

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify