MCP Tools Reference: gmailmcp.googleapis.com

টুল: search_threads

প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্ট থেকে ইমেইল থ্রেডগুলোর তালিকা দেখায়।

এই টুলটি কোয়েরি স্ট্রিং ব্যবহার করে থ্রেড ফিল্টার করতে পারে এবং পেজিনেশন সমর্থন করে। এটি থ্রেডগুলোর একটি তালিকা ফেরত দেয়, যার মধ্যে তাদের আইডি এবং সম্পর্কিত বার্তাগুলো অন্তর্ভুক্ত থাকে। প্রতিটি সম্পর্কিত বার্তায় বার্তার মূল অংশের একটি সংক্ষিপ্ত বিবরণ, বিষয়, প্রেরক, প্রাপক ইত্যাদির মতো বিস্তারিত তথ্য থাকে। উল্লেখ্য যে, এই টুলটি বার্তার সম্পূর্ণ মূল অংশ ফেরত দেয় না; প্রয়োজনে সম্পূর্ণ বার্তার মূল অংশটি পাওয়ার জন্য থ্রেড আইডি সহ 'get_thread' টুলটি ব্যবহার করুন।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` search_threads 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": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

SearchThreads RPC-এর জন্য অনুরোধ বার্তা।

সার্চথ্রেডস অনুরোধ

JSON উপস্থাপনা 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _page_size .

_page_size নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

pageSize

integer

ঐচ্ছিক। ফেরত দেওয়ার জন্য থ্রেডের সর্বোচ্চ সংখ্যা। নির্দিষ্ট না করা হলে, ডিফল্ট মান ২০ হয়। সর্বোচ্চ অনুমোদিত মান হলো ৫০।

ইউনিয়ন ফিল্ড _page_token .

_page_token নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

pageToken

string

ঐচ্ছিক। তালিকার ফলাফলের একটি নির্দিষ্ট পৃষ্ঠা আনার জন্য পৃষ্ঠা টোকেন। প্রথম পৃষ্ঠাটি আনতে এটি খালি রাখুন।

ইউনিয়ন ফিল্ড _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"

ইউনিয়ন ফিল্ড _include_trash .

_include_trash নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

includeTrash

boolean

ঐচ্ছিক। ফলাফলে ট্র্যাশ থেকে আসা খসড়া অন্তর্ভুক্ত করুন। ডিফল্টরূপে এটি ফলস থাকে।

আউটপুট স্কিমা

SearchThreads RPC-এর প্রতিক্রিয়া বার্তা।

সার্চথ্রেডসরেসপন্স

JSON উপস্থাপনা 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
threads[]

object ( Thread )

থ্রেড সারাংশগুলোর তালিকা।

nextPageToken

string

একটি টোকেন যা পরবর্তী কলে থ্রেডের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে। শুধুমাত্র তখনই উপস্থিত থাকে যখন আরও ফলাফল থাকে।

থ্রেড

JSON উপস্থাপনা 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
ক্ষেত্র
id

string

থ্রেডটির অনন্য শনাক্তকারী।

messages[]

object ( Message )

থ্রেডটিতে থাকা বার্তাগুলোর একটি তালিকা, যা কালানুক্রমিকভাবে সাজানো।

বার্তা

JSON উপস্থাপনা 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string
}
ক্ষেত্র
id

string

বার্তাটির অনন্য শনাক্তকারী।

snippet

string

বার্তার মূল অংশের একটি অংশ।

subject

string

হেডার থেকে সংগৃহীত বার্তার বিষয়:

sender

string

প্রেরকের ইমেল ঠিকানা।

toRecipients[]

string

প্রাপকের ইমেল ঠিকানায়।

ccRecipients[]

string

সিসি প্রাপকদের ইমেল ঠিকানা।

date

string

বার্তার তারিখ ISO 8601 ফরম্যাটে (YYYY-MM-DD)।

plaintextBody

string

সম্পূর্ণ মূল বিষয়বস্তু, যা শুধুমাত্র তখনই প্রদর্শিত হবে যদি MessageFormat-এর মান FULL_CONTENT হয়।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌