MCP Tools Reference: gmailmcp.googleapis.com

الأداة: label_message

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

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

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة label_message في "مجموعة أدوات التحكم في المحادثات" (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_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة الطلب لإجراء LabelMessage RPC.

LabelMessageRequest

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

string

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

string

الحقل مطلوب. أرقام تعريف التصنيفات التي يجب إضافتها. يمكن أن يكون رقم تعريف تصنيف نظام (مثل "الوارد" أو "المميّزة بنجمة" أو "غير مقروءة" أو "مهمة") أو رقم تعريف تصنيف محدّد من قِبل المستخدم. تقبل الأداة label_ids وليس أسماء التصنيفات. استخدِم أداة list_labels للحصول على رقم تعريف التصنيف المقابل لاسم العرض للتصنيفات المحدّدة من قِبل المستخدم.

مخطط النتائج

رسالة الردّ لإجراء LabelMessage RPC.

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

تلميح بشأن الإجراءات المدمّرة: ❌ | تلميح بشأن الإجراءات غير المؤثرة: ✅ | تلميح بشأن الإجراءات للقراءة فقط: ❌ | تلميح بشأن الإجراءات في العالم المفتوح: ❌

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

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