MCP Tools Reference: gmailmcp.googleapis.com

الأداة: label_thread

تضيف هذه الطريقة تصنيفات إلى سلسلة محادثات كاملة في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته. يؤثر هذا الإجراء في جميع الرسائل الحالية في سلسلة المحادثات وأي رسائل مستقبلية تُضاف إليها.

إذا لم تكن متأكدًا من رقم تعريف سلسلة المحادثات، استخدِم الأداة search_threads أولاً.

إذا لم تكن متأكّدًا من رقم تعريف تصنيف مستخدم، استخدِم الأداة list_labels أولاً للتعرّف على التصنيفات المتاحة وأرقام تعريفها.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة label_thread MCP.

طلب Curl 
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 عن بُعد

LabelThreadRequest

تمثيل JSON 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
الحقول
threadId

string

الحقل مطلوب. المعرّف الفريد لسلسلة المحادثات التي ستتم إضافة التصنيفات إليها.
labelIds[]

string

الحقل مطلوب. المعرّفات الفريدة للتصنيفات المطلوب إضافتها يمكن أن يكون معرّف تصنيف نظام (مثل INBOX أو TRASH أو SPAM أو STARRED أو UNREAD أو IMPORTANT) أو معرّف تصنيف محدّد من قِبل المستخدم. تقبل الأداة label_ids وليس أسماء التصنيفات. استخدِم أداة list_labels للحصول على معرّف التصنيف المناسب للاسم المعروض للتصنيفات التي يحدّدها المستخدم.

مخطط النتائج

رسالة الردّ على إجراء LabelThread عن بُعد.

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ❌ | Open World Hint: ❌