MCP Tools Reference: gmailmcp.googleapis.com

টুল: search_threads

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

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

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` search_threads MCP টুলটি চালু করতে হয়।

কার্ল অনুরোধ 
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": "search_threads",
    "arguments": {
      // provide these details according to the tool's 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

Optional. Page token to retrieve a specific page of results in the list. Leave empty to fetch the first page. This is primarily used for pagination to continue fetching results from where the previous SearchThreads call left off, especially when the number of threads matching the query exceeds the page_size limit.

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

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

query

string

Optional. A query string to filter the threads. Natural language queries must be pre-converted into Gmail syntax queries to use this tool. If omitted, all threads (excluding spam and trash by default) are listed.

বিভাগ অনুযায়ী সমর্থিত অপারেটর:

প্রেরক ও প্রাপক: থেকে: একজন নির্দিষ্ট ব্যক্তির কাছ থেকে প্রাপকের কাছে পাঠানো হয়েছে। কোনো নির্দিষ্ট ব্যক্তিকে পাঠানো হয়েছে। অনুলিপি: - সিসি. বিসিসি-তে থাকা নির্দিষ্ট ব্যক্তিরা: - বিসিসি-তে থাকা নির্দিষ্ট ব্যক্তিদের কাছে পাঠানো হয়েছে: - একটি নির্দিষ্ট ঠিকানায় পৌঁছে দেওয়া হয়েছে। তালিকা: একটি নির্দিষ্ট মেইলিং তালিকা থেকে।

সময় ও তারিখ: after:YYYY/MM/DD / newer:YYYY/MM/DD - কোনো তারিখের পরে প্রাপ্ত। before:YYYY/MM/DD / older:YYYY/MM/DD - কোনো তারিখের আগে প্রাপ্ত। older_than: একটি নির্দিষ্ট সময়কালের চেয়ে পুরোনো (যেমন, ১ বছর, ২ দিন)। newer_than: একটি নির্দিষ্ট সময়কালের চেয়ে নতুন।

বিষয়বস্তু: বিষয়: বিষয় লাইনে থাকা শব্দগুলো হলো: - নির্দিষ্ট ধরনের কন্টেন্ট রয়েছে (অ্যাটাচমেন্ট, ড্রাইভ, ইউটিউব, ডকুমেন্ট)। ফাইলের নাম: - নির্দিষ্ট নাম বা প্রকারের সংযুক্তি। "<শব্দ/বাক্যাংশ>" - কোনো সঠিক শব্দ বা বাক্যাংশ অনুসন্ধান করুন। (যেমন, "holiday", "holiday vacation")। + - একটি শব্দ হুবহু মেলান। (যেমন, +holiday, +unicorn) rfc822msgid: - নির্দিষ্ট মেসেজ আইডি হেডার। অ্যারাউন্ড কাছাকাছি থাকা শব্দগুলো খুঁজুন (যেমন, holiday, around 10 vacation)।

লেবেল ও বিভাগসমূহ: লেবেল: - একটি নির্দিষ্ট লেবেলের অধীনে। টুলটি লেবেল আইডি গ্রহণ করে, ডিসপ্লে নাম নয়। আইডি পেতে list_labels টুলটি ব্যবহার করুন। বিভাগ: - একটি ক্যাটাগরিতে (প্রাথমিক, সোশ্যাল, প্রোমোশন, আপডেট, ফোরাম, রিজার্ভেশন, পারচেজ)। in:

অবস্থা: হল: - স্ট্যাটাস অনুযায়ী অনুসন্ধান করুন (গুরুত্বপূর্ণ, তারকাচিহ্নিত, অপঠিত, পঠিত, মিউট করা)।

আকার: আকার: - বাইটে নির্দিষ্ট আকার। বৃহত্তর: / ছোট: আকারের চেয়ে বড় বা ছোট (যেমন, ১০ এমবি-র জন্য ১০এম)।

Logic & Grouping: AND - Match all criteria (default behavior). OR or { } - Match one or more criteria (eg, from:amy OR from:david, {from:amy from:david}). - (minus) - Exclude criteria (eg, -movie). ( ) - Group multiple search terms (eg, subject:(dinner film)).

উদাহরণ: "বিষয়:OneMCP আপডেট" "প্রেরক: user@example.com " "প্রাপক: user2@example.com এবং ৭ দিনের চেয়ে নতুন" "প্রকল্প প্রস্তাবে সংযুক্তি আছে" "খসড়া হিসেবে অপঠিত আছে"

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

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

includeTrash

boolean

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

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

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

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

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

object ( Thread )

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

nextPageToken

string

A token that can be used in a subsequent call to retrieve the next page of threads. Present only if there are more results. If the number of threads matching the query exceeds the page_size limit, the response will contain a next_page_token . To retrieve the next page of results, pass this token in the page_token field of the next SearchThreadsRequest .

থ্রেড

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,
  "attachmentIds": [
    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 হয়।

attachmentIds[]

string

শুধুমাত্র আউটপুট। অ্যাটাচমেন্ট আইডিগুলো কেবল তখনই পূরণ করা হবে, যদি MessageFormat-এর মান FULL_CONTENT হয়।

টুল টীকা

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