MCP Tools Reference: gmailmcp.googleapis.com

टूल: list_drafts

यह टूल, पुष्टि किए गए उपयोगकर्ता के Gmail खाते से ड्राफ़्ट किए गए ईमेल की सूची दिखाता है.

यह टूल, क्वेरी स्ट्रिंग के आधार पर ड्राफ़्ट को फ़िल्टर कर सकता है. साथ ही, यह पेज पर नतीजे दिखाने की सुविधा के साथ काम करता है. यह ड्राफ़्ट की सूची दिखाता है. इसमें ड्राफ़्ट के आईडी और विषय शामिल होते हैं. नतीजों को पेज पर दिखाने के लिए, page_token का इस्तेमाल किया जा सकता है. नतीजों के अगले पेज पाने के लिए, पिछली प्रतिक्रिया में मिले page_token का इस्तेमाल करें.

यहां दिए गए उदाहरण में, list_drafts MCP टूल को शुरू करने के लिए, curl का इस्तेमाल करने का तरीका बताया गया है.

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_drafts",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

ListDrafts RPC के लिए अनुरोध का मैसेज.

ListDraftsRequest

JSON के काेड में दिखाना 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
फ़ील्ड

यूनियन फ़ील्ड _page_size.

_page_size की वैल्यू इनमें से कोई एक हो सकती है:
pageSize

integer

ज़रूरी नहीं. ड्राफ़्ट की ज़्यादा से ज़्यादा संख्या, जो दिखाई जा सकती है. अगर कोई वैल्यू तय नहीं की जाती है, तो डिफ़ॉल्ट रूप से 20 ड्राफ़्ट दिखाए जाते हैं. ज़्यादा से ज़्यादा 50 ड्राफ़्ट दिखाए जा सकते हैं.

यूनियन फ़ील्ड _page_token.

_page_token की वैल्यू इनमें से कोई एक हो सकती है:
pageToken

string

ज़रूरी नहीं. नतीजों का अगला पेज पाने के लिए, list_drafts के पिछले कॉल से मिला टोकन. पहला पेज पाने के लिए, इसे खाली छोड़ें. इसका इस्तेमाल मुख्य तौर पर, पेज पर नतीजे दिखाने के लिए किया जाता है. इससे, नतीजे वहीं से फ़ेच किए जा सकते हैं जहां से ListDraft के पिछले कॉल में छोड़े गए थे. ऐसा तब किया जाता है, जब क्वेरी से मेल खाने वाले ड्राफ़्ट की संख्या, page_size की सीमा से ज़्यादा हो.

यूनियन फ़ील्ड _query.

_query की वैल्यू इनमें से कोई एक हो सकती है:
query

string

उदाहरण: "subject:OneMCP Update" "from:gduser1@workspacesamples.dev" "to:gduser2@workspacesamples.dev AND newer_than:7d" "project proposal has:attachment" "is:unread"

अगर क्वेरी में संख्या का इस्तेमाल किया जाता है, तो उन्हें अलग-अलग करने के लिए, स्पेस या डैश (-) का इस्तेमाल किया जा सकता है. साथ ही, दशमलव लगाने के लिए डॉट (.) का इस्तेमाल किया जा सकता है. उदाहरण के लिए, 01.2047-100 को दो संख्याओं के तौर पर देखा जाता है: 01.2047 और 100.

ध्यान दें: अगर हमें यह पक्का करना है कि क्वेरी के लिए सभी ड्राफ़्ट दिखाए जाएं, तो हम नतीजों को पेज पर दिखा सकते हैं. इसके लिए, टूल को बार-बार कॉल किया जा सकता है. ऐसा तब तक किया जा सकता है, जब तक कि प्रतिक्रिया में ड्राफ़्ट की खाली सूची न मिले.

आउटपुट स्कीमा

ListDrafts RPC के लिए जवाब का मैसेज.

ListDraftsResponse

JSON के काेड में दिखाना 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
drafts[]

object (Draft)

ड्राफ़्ट की सूची.
nextPageToken

string

यह एक टोकन है. इसका इस्तेमाल, ड्राफ़्ट का अगला पेज पाने के लिए, बाद में किए जाने वाले कॉल में किया जा सकता है. अगर क्वेरी से मेल खाने वाले ड्राफ़्ट की संख्या, page_size की सीमा से ज़्यादा है, तो जवाब में next_page_token शामिल होगा. नतीजों का अगला पेज पाने के लिए, इस टोकन को ListDraftsRequest के अगले page_token फ़ील्ड में पास करें.

ड्राफ़्ट

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

हेडर से निकाले गए, 'कॉपी' फ़ील्ड में शामिल ईमेल पतों की सूची.
bccRecipients[]

string

हेडर से निकाले गए, 'गुप्त कॉपी' फ़ील्ड में शामिल ईमेल पतों की सूची.
plaintextBody

string

अगर उपलब्ध हो, तो सादे टेक्स्ट में मैसेज का कॉन्टेंट.
date

string

आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DD) में ड्राफ़्ट की तारीख.

टूल के एनोटेशन

डिस्ट्रक्टिव हिंट: ❌ | आइडेंपोटेंट हिंट: ❌ | रीड ओनली हिंट: ❌ | ओपन वर्ल्ड हिंट: ❌