MCP Tools Reference: gmailmcp.googleapis.com

الأداة: label_thread

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

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

إذا لم تكن متأكدًا من رقم تعريف تصنيف مستخدم، استخدِم أداة list_labels أولاً لاكتشاف التصنيفات المتاحة وأرقام تعريفها. لإضافة تصنيف "المهملات" أو تصنيف "الرسائل غير المرغوب فيها" إلى سلسلة محادثات، يُرجى استخدام أداة apply_sensitive_thread_label بدلاً من ذلك.

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

طلب Curl 
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)

LabelThreadRequest

تمثيل 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