MCP Tools Reference: gmailmcp.googleapis.com

الأداة: list_labels

تعرض هذه الأداة جميع التصنيفات التي يحدّدها المستخدم والمتاحة في حساب Gmail الخاص بالمستخدم الذي تم التحقّق من هويته. استخدِم هذه الأداة للعثور على id لتصنيف مستخدم قبل استدعاء label_thread أو unlabel_thread أو label_message أو unlabel_message. لا تعرض هذه الأداة تصنيفات النظام، ولكن يمكن استخدامها مع المعرّفات المعروفة: INBOX وTRASH وSPAM وSTARRED وUNREAD وIMPORTANT وCHAT وDRAFT وSENT.

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

مخطط الإدخال

رسالة الطلب لاستدعاء إجراء ListLabels عن بُعد (RPC)

ListLabelsRequest

تمثيل JSON 
{

  "pageSize": integer

  "pageToken": string
}
الحقول

حقل الربط _page_size

يمكن أن يكون _page_size إحدى القيم التالية فقط:
pageSize

integer

اختياريّ. الحد الأقصى لعدد التصنيفات المطلوب عرضها.

حقل الربط _page_token

يمكن أن يكون _page_token إحدى القيم التالية فقط:
pageToken

string

اختياريّ. رمز الصفحة لاسترداد صفحة معيّنة من النتائج في القائمة

مخطط الرد

رسالة الرد لاستدعاء إجراء ListLabels عن بُعد (RPC)

ListLabelsResponse

تمثيل JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
الحقول
labels[]

object (Label)

قائمة بتصنيفات المستخدم في حسابه
nextPageToken

string

رمز لاسترداد الصفحة التالية من النتائج في القائمة

التصنيف

تمثيل 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)

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

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