MCP Tools Reference: gmailmcp.googleapis.com

ابزار: list_labels

تمام برچسب‌های تعریف‌شده توسط کاربر موجود در حساب جیمیل کاربر احراز هویت‌شده را فهرست می‌کند. از این ابزار برای کشف id برچسب کاربر قبل از فراخوانی label_thread ، unlabel_thread ، label_message یا unlabel_message استفاده کنید. برچسب‌های سیستم توسط این ابزار بازگردانده نمی‌شوند، اما می‌توانند با شناسه‌های شناخته‌شده‌شان مورد استفاده قرار گیرند: 'INBOX'، 'TRASH'، 'SPAM'، 'STARRED'، 'UNREAD'، 'IMPORTANT'، 'CHAT'، 'DRAFT'، 'SENT'.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار list_labels MCP را نشان می‌دهد.

درخواست کرل 
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
}'

طرحواره ورودی

درخواست پیام برای RPC مربوط به ListLabels.

درخواست برچسب‌های لیست

نمایش JSON 
{

  "pageSize": integer

  "pageToken": string
}
فیلدها

فیلد یونیون _page_size .

_page_size می‌تواند فقط یکی از موارد زیر باشد:

pageSize

integer

اختیاری. حداکثر تعداد برچسب‌هایی که باید برگردانده شوند.

فیلد یونیون _page_token .

_page_token فقط می‌تواند یکی از موارد زیر باشد:

pageToken

string

اختیاری. توکن صفحه برای بازیابی یک صفحه خاص از نتایج در لیست.

طرحواره خروجی

پیام پاسخ برای RPC لیست‌لیبل‌ها.

پاسخ ListLabels

نمایش JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
فیلدها
labels[]

object ( Label )

فهرست برچسب‌های کاربری در حساب کاربری.

nextPageToken

string

توکن برای بازیابی صفحه بعدی نتایج در لیست.

برچسب

نمایش JSON 
{
  "labelId": string,
  "name": string
}
فیلدها
labelId

string

شناسه منحصر به فرد برچسب.

name

string

نام نمایشیِ قابل خواندن توسط انسان برای برچسب.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌