টুল: search_threads
যাচাইকৃত ব্যবহারকারীর Gmail অ্যাকাউন্ট থেকে ইমেল থ্রেডের তালিকা দেখায়।
এই টুল কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে থ্রেড ফিল্টার করতে পারে এবং পৃষ্ঠা সংখ্যা দেখায়। এটি থ্রেডের আইডি ও সম্পর্কিত মেসেজ সহ থ্রেডের তালিকা দেখায়। প্রতিটি সম্পর্কিত মেসেজে মেসেজের বডির স্নিপেট, বিষয়, প্রেরক, প্রাপক ইত্যাদির মতো বিবরণ থাকে। view প্যারামিটারটি সম্পর্কিত মেসেজে কোন কোন ফিল্ড পূরণ করা হবে তা নিয়ন্ত্রণ করে। ডিফল্ট হিসেবে (অথবা THREAD_VIEW_MINIMAL-এর সাথে), এতে বিষয় ও স্নিপেট অন্তর্ভুক্ত থাকে। বিষয় ও স্নিপেট বাদ দিতে THREAD_VIEW_METADATA_ONLY ব্যবহার করুন। মনে রাখবেন যে এই টুল সম্পূর্ণ মেসেজের বিষয়বস্তু ফিরিয়ে দেয় না; প্রয়োজন হলে সম্পূর্ণ মেসেজের বিষয়বস্তু নিয়ে আসার জন্য থ্রেড আইডি সহ 'get_thread' টুল ব্যবহার করুন। বাদ দেওয়া মাপকাঠি সহ থ্রেড এখনও ফলাফলে দেখা যেতে পারে। এটি ঘটে কারণ Gmail প্রথমে ম্যাচিং মেসেজ শনাক্ত করে। যেমন, আপনি -is:starred সার্চ করলে, Gmail এমন একটি সম্পূর্ণ থ্রেড খুঁজে পাবে যাতে অন্তত একটি স্টার না দেওয়া মেসেজ আছে, এমনকি সেই একই কথোপকথনের অন্যান্য ইমেলে স্টার দেওয়া থাকলেও।
নিচের স্যাম্পেল থেকে বোঝা যায় যে search_threads MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয়।
| Curl অনুরোধ |
|---|
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --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-এর জন্য অনুরোধের মেসেজ।
SearchThreadsRequest
| JSON উপস্থাপনা |
|---|
{
"pageSize": integer,
"pageToken": string,
"query": string,
"includeTrash": boolean,
"view": enum ( |
| ফিল্ড | |
|---|---|
ইউনিয়ন ফিল্ড
|
|
pageSize |
ঐচ্ছিক। ফেরত দেওয়ার জন্য থ্রেডের সর্বাধিক সংখ্যা। নির্দিষ্ট করা না থাকলে, ডিফল্ট হল ২০। সর্বাধিক অনুমোদিত মান হল ৫০। |
ইউনিয়ন ফিল্ড
|
|
pageToken |
ঐচ্ছিক। তালিকায় ফলাফলের নির্দিষ্ট পৃষ্ঠা ফিরিয়ে আনতে পৃষ্ঠা টোকেন। প্রথম পৃষ্ঠাটি আনার জন্য জায়গাটি খালি রাখুন। এটি মূলত পেজিনেশনের জন্য ব্যবহার করা হয় যাতে আগের |
ইউনিয়ন ফিল্ড
|
|
query |
ঐচ্ছিক। থ্রেড ফিল্টার করার জন্য একটি কোয়েরি স্ট্রিং। এই টুল ব্যবহার করতে হলে, ন্যাচারাল ল্যাঙ্গুয়েজ কোয়েরি অবশ্যই Gmail সিনট্যাক্স কোয়েরিতে আগে থেকে কনভার্ট করা থাকতে হবে। বাদ দেওয়া হলে, সব থ্রেড (ডিফল্ট হিসেবে স্প্যাম ও ট্র্যাশ বাদ দিয়ে) তালিকাভুক্ত করা হয়। বিভাগ অনুযায়ী কাজ করে এমন অপারেটর: প্রেরক ও প্রাপক:
সময় ও তারিখ:
কন্টেন্ট:
লেবেল ও বিভাগ:
স্ট্যাটাস:
মাপ:
লজিক ও গ্রুপিং:
উদাহরণ:
|
ইউনিয়ন ফিল্ড
|
|
includeTrash |
ঐচ্ছিক। ফলাফলে ট্র্যাশ থেকে থ্রেড অন্তর্ভুক্ত করুন। ডিফল্ট হিসেবে false সেট করা থাকে। |
ইউনিয়ন ফিল্ড
|
|
view |
ঐচ্ছিক। থ্রেড তালিকায় থ্রেডের জন্য পপুলেট করা ফিল্ড কন্ট্রোল করে। ডিফল্ট হিসেবে THREAD_VIEW_MINIMAL-এ সেট করা থাকে। THREAD_VIEW_MINIMAL, id, snippet, subject, from, to, cc, date, labelIds রিটার্ন করে। THREAD_VIEW_METADATA_ONLY আইডি, থেকে, পর্যন্ত, সিসি, তারিখ, labelIds রিটার্ন করে। |
ThreadView
ListThreads এবং SearchThreads উত্তরে থ্রেডের জন্য পপুলেট করা ফিল্ড নিয়ন্ত্রণ করার enum।
| Enums | |
|---|---|
THREAD_VIEW_UNSPECIFIED |
ব্যাকওয়ার্ড কম্প্যাটিবিলিটির জন্য THREAD_VIEW_MINIMAL-এ ম্যাপ করে। |
THREAD_VIEW_METADATA_ONLY |
id, from, to, cc, date, labelIds দেখায়। |
THREAD_VIEW_MINIMAL |
id, snippet, subject, from, to, cc, date, labelIds রিটার্ন করে। |
আউটপুট স্কিমা
SearchThreads RPC-এর জন্য উত্তর মেসেজ।
SearchThreadsResponse
| JSON উপস্থাপনা |
|---|
{
"threads": [
{
object ( |
| ফিল্ড | |
|---|---|
threads[] |
থ্রেডের সারাংশের তালিকা। |
nextPageToken |
একটি টোকেন যা থ্রেডের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে পরবর্তী কলে ব্যবহার করা যেতে পারে। আরও ফলাফল থাকলে তবেই দেখান। কোয়েরির সাথে ম্যাচ করা থ্রেডের সংখ্যা page_size সীমা অতিক্রম করলে, উত্তরে |
resultCountEstimate |
এই কোয়েরির জন্য আনুমানিক ফলাফল সংখ্যা। এটি সর্বনিম্ন সীমা হিসেবে বিবেচনা করা উচিত, তাই উদাহরণস্বরূপ, এটি ৫০০ হলে, ব্যবহারকারীকে "৫০০+" হিসেবে সংখ্যাটি জানানো যেতে পারে। |
থ্রেড
| JSON উপস্থাপনা |
|---|
{
"id": string,
"messages": [
{
object ( |
| ফিল্ড | |
|---|---|
id |
থ্রেডের অনন্য শনাক্তকারী। |
messages[] |
থ্রেডে থাকা মেসেজের তালিকা, কালানুক্রমিকভাবে সাজানো। |
মেসেজ
| JSON উপস্থাপনা |
|---|
{
"id": string,
"snippet": string,
"subject": string,
"sender": string,
"toRecipients": [
string
],
"ccRecipients": [
string
],
"date": string,
"plaintextBody": string,
"attachmentIds": [
string
],
"htmlBody": string,
"attachments": [
{
object ( |
| ফিল্ড | |
|---|---|
id |
মেসেজের অনন্য শনাক্তকারী। |
snippet |
মেসেজের বডির স্নিপেট। |
subject |
হেডার থেকে মেসেজের বিষয় এক্সট্র্যাক্ট করা হয়েছে: |
sender |
প্রেরকের ইমেল আইডি। |
toRecipients[] |
প্রাপকের ইমেল আইডিতে। |
ccRecipients[] |
CC প্রাপকের ইমেল আইডি। |
date |
ISO 8601 ফর্ম্যাটে (YYYY-MM-DD) মেসেজের তারিখ। |
plaintextBody |
সম্পূর্ণ বডি কন্টেন্ট, MessageFormat, FULL_CONTENT হলে তবেই পপুলেট করা হয়। |
attachmentIds[] |
শুধু আউটপুট। অ্যাটাচমেন্ট আইডি, MessageFormat, FULL_CONTENT হলে তবেই পপুলেট করা হয়। |
htmlBody |
ইমেলের HTML কন্টেন্ট, MessageFormat যদি FULL_CONTENT হয়, তবেই শুধু পপুলেট করা হয়। |
attachments[] |
শুধু আউটপুট। অ্যাটাচমেন্ট, শুধুমাত্র MessageFormat FULL_CONTENT হলে তবেই পপুলেট করা হয়। |
labelIds[] |
মেসেজে অ্যাটাচ করা লেবেলের আইডি। ব্যবহারকারীর লেবেল এবং স্ট্যান্ডার্ড সিস্টেম লেবেলের আইডি অন্তর্ভুক্ত করে যা |
AttachmentMetadata
| JSON উপস্থাপনা |
|---|
{ "id": string, "mimeType": string, "filename": string } |
| ফিল্ড | |
|---|---|
id |
শুধু আউটপুট। অ্যাটাচমেন্টের আইডি। |
mimeType |
অ্যাটাচমেন্টের MIME-এর প্রকার। |
filename |
অ্যাটাচমেন্টের ফাইলের নাম। |
টুল অ্যানোটেশন
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
অনুমোদনের স্কোপ
নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:
https://mail.google.com/https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.readonly