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 '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

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

مخطط النتائج

رسالة الرد على إجراء UnlabelMessage RPC

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

تلميح مدمر: ✅ | تلميح متكرر: ✅ | تلميح للقراءة فقط: ❌ | تلميح للعالم المفتوح: ❌