MCP Tools Reference: gmailmcp.googleapis.com

टूल: list_drafts

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

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

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

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_drafts",
    "arguments": {
      // provide these details according to the tool 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 के पिछले कॉल से मिला है. इसका इस्तेमाल, नतीजों का अगला पेज पाने के लिए किया जाता है. पहले पेज का डेटा पाने के लिए, इसे खाली छोड़ें.

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

_query इनमें से सिर्फ़ एक हो सकता है:
query

string

ज़रूरी नहीं. ड्राफ़्ट फ़िल्टर करने के लिए क्वेरी स्ट्रिंग. इसका फ़ॉर्मैट, Gmail के खोज बार जैसा ही होता है. अगर इसे शामिल नहीं किया जाता है, तो सभी ड्राफ़्ट (डिफ़ॉल्ट रूप से स्पैम और ट्रैश को छोड़कर) दिखते हैं. मुख्य ऑपरेटर: from: - किसी व्यक्ति से मिले मैसेज. to: - किसी व्यक्ति को भेजे गए मैसेज. विषय: - ऐसे मैसेज जिनके विषय में कुछ खास शब्द शामिल हैं. - ऐसे मैसेज जिनमें मुख्य हिस्से या विषय में कुछ खास शब्द शामिल हों. 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"

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

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

ListDraftsResponse

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

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

string

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

string

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

string

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

टूल एनोटेशन

बदलाव करने से जुड़ी जानकारी: ❌ | एक ही बार लागू होने से जुड़ी जानकारी: ❌ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ❌ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌