MCP Tools Reference: gmailmcp.googleapis.com

الأداة: unlabel_message

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

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

مخطط الإدخال

رسالة الطلب لـ UnlabelMessage RPC.

UnlabelMessageRequest

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

string

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

string

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

مخطط النتائج

رسالة الردّ لـ UnlabelMessage RPC.

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

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

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

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

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