MCP Tools Reference: gmailmcp.googleapis.com

टूल: list_labels

यह टूल, पुष्टि किए गए उपयोगकर्ता के Gmail खाते में मौजूद, उपयोगकर्ता के तय किए गए सभी लेबल की सूची दिखाता है. label_thread, unlabel_thread, label_message, या unlabel_message को कॉल करने से पहले, उपयोगकर्ता के लेबल का id जानने के लिए इस टूल का इस्तेमाल करें. यह टूल, सिस्टम लेबल नहीं दिखाता. हालांकि, इन्हें इनके जाने-माने आईडी के साथ इस्तेमाल किया जा सकता है: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'.

यहां दिए गए उदाहरण में, list_labels 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_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

ज़रूरी नहीं. सूची में नतीजों का कोई खास पेज वापस पाने के लिए, पेज टोकन.

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

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

ListLabelsResponse

JSON के काेड में दिखाना 
{
  "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

लेबल के तहत, नहीं पढ़े गए थ्रेड की संख्या.

LabelColor

JSON के काेड में दिखाना 
{
  "textColor": string,
  "backgroundColor": string
}
फ़ील्ड
textColor

string

लेबल का टेक्स्ट कलर, जिसे हेक्स स्ट्रिंग के तौर पर दिखाया जाता है. जैसे, "#000000".
backgroundColor

string

लेबल का बैकग्राउंड कलर, जिसे हेक्स स्ट्रिंग के तौर पर दिखाया जाता है. जैसे, "#ffffff".

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

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ✅ | सिर्फ़ पढ़ने की अनुमति वाली हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌