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' \
--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 MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

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

ListLabelsRequest

تمثيل JSON 
{

  "pageSize": integer

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

حقل الربط _page_size

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

integer

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

حقل الربط _page_token

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

string

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

مخطط النتائج

رسالة الرد على استدعاء إجراء ListLabels عن بُعد.

ListLabelsResponse

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

object (Label)

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

string

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

التصنيف

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

string

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

string

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

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

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