MCP Tools Reference: gmailmcp.googleapis.com

ابزار: list_drafts

ایمیل‌های پیش‌نویس را از حساب جیمیل کاربر احراز هویت‌شده فهرست می‌کند.

این ابزار می‌تواند پیش‌نویس‌ها را بر اساس یک رشته پرس‌وجو فیلتر کند و از صفحه‌بندی پشتیبانی می‌کند. این ابزار لیستی از پیش‌نویس‌ها، شامل شناسه‌ها و موضوعات آنها را برمی‌گرداند.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار list_drafts 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_drafts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

درخواست پیش‌نویس‌ها

نمایش JSON 
{

  "pageSize": integer

  "pageToken": string

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

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

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

pageSize

integer

اختیاری. حداکثر تعداد پیش‌نویس‌هایی که باید برگردانده شوند. اگر مشخص نشود، پیش‌فرض ۲۰ است. حداکثر مقدار مجاز ۵۰ است.

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

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

pageToken

string

اختیاری. توکنی که از فراخوانی قبلی list_drafts برای بازیابی صفحه بعدی نتایج دریافت شده است. برای دریافت صفحه اول، آن را خالی بگذارید.

فیلد یونیون _query .

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

query

string

اختیاری. یک رشته پرس‌وجو برای فیلتر کردن پیش‌نویس‌ها، با استفاده از همان قالب نوار جستجوی جیمیل. در صورت حذف، همه پیش‌نویس‌ها (به استثنای هرزنامه و سطل زباله به طور پیش‌فرض) فهرست می‌شوند. عملگرهای کلیدی: from: - پیام‌هایی از یک فرستنده خاص به: - پیام‌های ارسال شده به یک گیرنده خاص. موضوع: - پیام‌هایی با کلمات خاص در موضوع. - پیام‌هایی که حاوی کلمات خاص در بدنه یا موضوع هستند. is:unread - پیام‌های خوانده نشده. is:starred - پیام‌های ستاره‌دار. has:attachment - پیام‌های دارای پیوست. after:YYYY/MM/DD - پیام‌های ارسال شده پس از یک تاریخ. before:YYYY/MM/DD - پیام‌های ارسال شده قبل از یک تاریخ. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

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

پیام پاسخ برای RPC مربوط به ListDrafts.

پاسخ به پیش نویس های لیست

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

object ( Draft )

فهرست پیش‌نویس‌ها.

nextPageToken

string

توکنی که می‌تواند در فراخوانی بعدی برای بازیابی صفحه بعدی پیش‌نویس‌ها استفاده شود. فقط در صورتی ارائه می‌شود که نتایج بیشتری وجود داشته باشد.

پیش نویس

نمایش JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
فیلدها
id

string

شناسه منحصر به فرد منبع پیش نویس.

subject

string

موضوع پیش‌نویس پیام.

threadId

string

شناسه‌ی تاپیکی که این پیش‌نویس به آن تعلق دارد.

toRecipients[]

string

فهرست آدرس‌های ایمیل گیرنده «به» که از سربرگ‌ها استخراج شده‌اند.

ccRecipients[]

string

فهرست آدرس‌های ایمیل گیرنده «Cc» که از سربرگ‌ها استخراج شده‌اند.

bccRecipients[]

string

فهرست آدرس‌های ایمیل گیرنده «Bcc» که از سربرگ‌ها استخراج شده‌اند.

plaintextBody

string

متن ساده‌ی محتوای بدنه، در صورت وجود.

date

string

تاریخ پیش‌نویس در قالب ISO 8601 (YYYY-MM-DD).

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

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