Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --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 }'

طلب Curl

curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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` اختياريّ. رمز مميّز للصفحة لاسترداد صفحة معيّنة من النتائج في القائمة.

حقل الربط _page_size

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

pageSize

integer

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

حقل الربط _page_token

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

pageToken

string

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

مخطط النتائج

رسالة الردّ على استدعاء إجراء عن بُعد (RPC) الخاص بـ ListLabels.

ListLabelsResponse

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

الحقول

الحقول
`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` عدد سلاسل المحادثات غير المقروءة ضمن التصنيف

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"). يُسمح فقط بالمجموعة المحدّدة مسبقًا من قيم الألوان التالية: `#000000` و`#434343` و`#666666` و`#999999` و`#cccccc` و`#efefef` و`#f3f3f3` و`#ffffff` و`#fb4c2f` و`#ffad47` و`#fad165` و`#16a766` و`#43d692` و`#4a86e8` و`#a479e2` و`#f691b3` و`#f6c5be` و`#ffe6c7` و`#fef1d1` و`#b9e4d0` و`#c6f3de` و`#c9daf8` و`#e4d7f5` و`#fcdee8` و`#efa093` و`#ffd6a2` و`#fce8b3` و`#89d3b2` و`#a0eac9` و`#a4c2f4` و`#d0bcf1` و`#fbc8d9` و`#e66550` و`#ffbc6b` و`#fcda83` و`#44b984` و`#68dfa9` و`#6d9eeb` و`#b694e8` و`#f7a7c0` و`#cc3a21` و`#eaa041` و`#f2c960` و`#149e60` و`#3dc789` و`#3c78d8` و`#8e63ce` و`#e07798` و`#ac2b16` و`#cf8933` و`#d5ae49` و`#0b804b` و`#2a9c68` و`#285bac` و`#653e9b` و`#b65775` و`#822111` و`#a46a21` و`#aa8831` و`#076239` و`#1a764d` و`#1c4587` و`#41236d` و`#83334c` و`#464646` و`#e7e7e7` و`#0d3472` و`#b6cff5` و`#0d3b44` و`#98d7e4` و`#3d188e` و`#e3d7ff` و`#711a36` و`#fbd3e0` و`#8a1c0a` و`#f2b2a8` و`#7a2e0b` و`#ffc8af` و`#7a4706` و`#ffdeb5` و`#594c05` و`#fbe983` و`#684e07` و`#fdedc1` و`#0b4f30` و`#b3efd3` و`#04502e` و`#a2dcc1` و`#c2c2c2` و`#4986e7` و`#2da2bb` و`#b99aff` و`#994a64` و`#f691b2` و`#ff7537` و`#ffad46` و`#662e37` و`#ebdbde` و`#cca6ac` و`#094228` و`#42d692` و`#16a765`
`backgroundColor`	`string` لون خلفية التصنيف، ويتم تمثيله كسلسلة سداسية عشرية (مثل "#ffffff"). يُسمح فقط بالمجموعة المحدّدة مسبقًا من قيم الألوان التالية: `#000000` و`#434343` و`#666666` و`#999999` و`#cccccc` و`#efefef` و`#f3f3f3` و`#ffffff` و`#fb4c2f` و`#ffad47` و`#fad165` و`#16a766` و`#43d692` و`#4a86e8` و`#a479e2` و`#f691b3` و`#f6c5be` و`#ffe6c7` و`#fef1d1` و`#b9e4d0` و`#c6f3de` و`#c9daf8` و`#e4d7f5` و`#fcdee8` و`#efa093` و`#ffd6a2` و`#fce8b3` و`#89d3b2` و`#a0eac9` و`#a4c2f4` و`#d0bcf1` و`#fbc8d9` و`#e66550` و`#ffbc6b` و`#fcda83` و`#44b984` و`#68dfa9` و`#6d9eeb` و`#b694e8` و`#f7a7c0` و`#cc3a21` و`#eaa041` و`#f2c960` و`#149e60` و`#3dc789` و`#3c78d8` و`#8e63ce` و`#e07798` و`#ac2b16` و`#cf8933` و`#d5ae49` و`#0b804b` و`#2a9c68` و`#285bac` و`#653e9b` و`#b65775` و`#822111` و`#a46a21` و`#aa8831` و`#076239` و`#1a764d` و`#1c4587` و`#41236d` و`#83334c` و`#464646` و`#e7e7e7` و`#0d3472` و`#b6cff5` و`#0d3b44` و`#98d7e4` و`#3d188e` و`#e3d7ff` و`#711a36` و`#fbd3e0` و`#8a1c0a` و`#f2b2a8` و`#7a2e0b` و`#ffc8af` و`#7a4706` و`#ffdeb5` و`#594c05` و`#fbe983` و`#684e07` و`#fdedc1` و`#0b4f30` و`#b3efd3` و`#04502e` و`#a2dcc1` و`#c2c2c2` و`#4986e7` و`#2da2bb` و`#b99aff` و`#994a64` و`#f691b2` و`#ff7537` و`#ffad46` و`#662e37` و`#ebdbde` و`#cca6ac` و`#094228` و`#42d692` و`#16a765`

textColor

string

لون نص التصنيف، ويتم تمثيله كسلسلة سداسية عشرية (مثل "#000000"). يُسمح فقط بالمجموعة المحدّدة مسبقًا من قيم الألوان التالية: #000000 و#434343 و#666666 و#999999 و#cccccc و#efefef و#f3f3f3 و#ffffff و#fb4c2f و#ffad47 و#fad165 و#16a766 و#43d692 و#4a86e8 و#a479e2 و#f691b3 و#f6c5be و#ffe6c7 و#fef1d1 و#b9e4d0 و#c6f3de و#c9daf8 و#e4d7f5 و#fcdee8 و#efa093 و#ffd6a2 و#fce8b3 و#89d3b2 و#a0eac9 و#a4c2f4 و#d0bcf1 و#fbc8d9 و#e66550 و#ffbc6b و#fcda83 و#44b984 و#68dfa9 و#6d9eeb و#b694e8 و#f7a7c0 و#cc3a21 و#eaa041 و#f2c960 و#149e60 و#3dc789 و#3c78d8 و#8e63ce و#e07798 و#ac2b16 و#cf8933 و#d5ae49 و#0b804b و#2a9c68 و#285bac و#653e9b و#b65775 و#822111 و#a46a21 و#aa8831 و#076239 و#1a764d و#1c4587 و#41236d و#83334c و#464646 و#e7e7e7 و#0d3472 و#b6cff5 و#0d3b44 و#98d7e4 و#3d188e و#e3d7ff و#711a36 و#fbd3e0 و#8a1c0a و#f2b2a8 و#7a2e0b و#ffc8af و#7a4706 و#ffdeb5 و#594c05 و#fbe983 و#684e07 و#fdedc1 و#0b4f30 و#b3efd3 و#04502e و#a2dcc1 و#c2c2c2 و#4986e7 و#2da2bb و#b99aff و#994a64 و#f691b2 و#ff7537 و#ffad46 و#662e37 و#ebdbde و#cca6ac و#094228 و#42d692 و#16a765

backgroundColor

string

لون خلفية التصنيف، ويتم تمثيله كسلسلة سداسية عشرية (مثل "#ffffff"). يُسمح فقط بالمجموعة المحدّدة مسبقًا من قيم الألوان التالية: #000000 و#434343 و#666666 و#999999 و#cccccc و#efefef و#f3f3f3 و#ffffff و#fb4c2f و#ffad47 و#fad165 و#16a766 و#43d692 و#4a86e8 و#a479e2 و#f691b3 و#f6c5be و#ffe6c7 و#fef1d1 و#b9e4d0 و#c6f3de و#c9daf8 و#e4d7f5 و#fcdee8 و#efa093 و#ffd6a2 و#fce8b3 و#89d3b2 و#a0eac9 و#a4c2f4 و#d0bcf1 و#fbc8d9 و#e66550 و#ffbc6b و#fcda83 و#44b984 و#68dfa9 و#6d9eeb و#b694e8 و#f7a7c0 و#cc3a21 و#eaa041 و#f2c960 و#149e60 و#3dc789 و#3c78d8 و#8e63ce و#e07798 و#ac2b16 و#cf8933 و#d5ae49 و#0b804b و#2a9c68 و#285bac و#653e9b و#b65775 و#822111 و#a46a21 و#aa8831 و#076239 و#1a764d و#1c4587 و#41236d و#83334c و#464646 و#e7e7e7 و#0d3472 و#b6cff5 و#0d3b44 و#98d7e4 و#3d188e و#e3d7ff و#711a36 و#fbd3e0 و#8a1c0a و#f2b2a8 و#7a2e0b و#ffc8af و#7a4706 و#ffdeb5 و#594c05 و#fbe983 و#684e07 و#fdedc1 و#0b4f30 و#b3efd3 و#04502e و#a2dcc1 و#c2c2c2 و#4986e7 و#2da2bb و#b99aff و#994a64 و#f691b2 و#ff7537 و#ffad46 و#662e37 و#ebdbde و#cca6ac و#094228 و#42d692 و#16a765

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

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

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.labels
https://www.googleapis.com/auth/gmail.metadata

MCP Tools Reference: gmailmcp.googleapis.com تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الأداة: list_labels

مخطط الإدخال

ListLabelsRequest

مخطط النتائج

ListLabelsResponse

التصنيف

LabelColor

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

نطاقات التفويض

MCP Tools Reference: gmailmcp.googleapis.com

الأداة: `list_labels`