MCP Tools Reference: gmailmcp.googleapis.com

الأداة: label_message

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

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

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة label_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": "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

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

مخطط النتائج

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

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

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