MCP Tools Reference: gmailmcp.googleapis.com

الأداة: create_label

تنشئ هذه الطريقة تصنيفًا جديدًا في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته.

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

مخطط الإدخال

رسالة الطلب لإجراء CreateLabel عن بُعد

CreateLabelRequest

تمثيل JSON 
{
  "displayName": string,

  "color": {
    object (LabelColor)
  }
}
الحقول
displayName

string

الحقل مطلوب. الاسم المعروض للتصنيف المطلوب إنشاؤه.

حقل الربط _color

يمكن أن يكون التعليق _color إحدى القيم التالية فقط:
color

object (LabelColor)

اختياريّ. لون التصنيف

LabelColor

تمثيل JSON 
{
  "textColor": string,
  "backgroundColor": string
}
الحقول
textColor

string

لون نص التصنيف، ويتم تمثيله كسلسلة سداسية عشرية (مثلاً "#000000").
backgroundColor

string

لون خلفية التصنيف، ويتم تمثيله كسلسلة سداسية عشرية (مثل "#ffffff").

مخطط النتائج

تفاصيل التصنيف

التصنيف

تمثيل JSON 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
الحقول
labelId

string

المعرّف الفريد للتصنيف.
name

string

الاسم المعروض للتصنيف والذي يمكن لشخص عادي قراءته.
color

object (LabelColor)

اختياريّ. لون التصنيف

حقل الربط _threads_total

يمكن أن يكون التعليق _threads_total إحدى القيم التالية فقط:
threadsTotal

integer

تمثّل هذه السمة إجمالي عدد سلاسل المحادثات ضمن التصنيف.

حقل الربط _threads_unread

يمكن أن يكون التعليق _threads_unread إحدى القيم التالية فقط:
threadsUnread

integer

عدد سلاسل المحادثات غير المقروءة ضمن التصنيف

LabelColor

تمثيل JSON 
{
  "textColor": string,
  "backgroundColor": string
}
الحقول
textColor

string

لون نص التصنيف، ويتم تمثيله كسلسلة سداسية عشرية (مثلاً "#000000").
backgroundColor

string

لون خلفية التصنيف، ويتم تمثيله كسلسلة سداسية عشرية (مثل "#ffffff").

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

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