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' \
--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 عن بُعد

LabelThreadRequest

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

string

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

string

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

مخطط النتائج

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

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

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