MCP Tools Reference: gmailmcp.googleapis.com

টুল: get_thread

ডেভেলপার প্রিভিউ: গুগল ওয়ার্কস্পেস ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলব্ধ, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস প্রদান করে।

প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্ট থেকে একটি নির্দিষ্ট ইমেইল থ্রেড পুনরুদ্ধার করে, যার মধ্যে এর বার্তাগুলোর একটি তালিকাও অন্তর্ভুক্ত থাকে।

ঐচ্ছিক messageFormat প্যারামিটারটি ফেরত আসা মেসেজগুলোর ফরম্যাট নিয়ন্ত্রণ করে। ডিফল্টরূপে (অথবা FULL_CONTENT ব্যবহার করলে), এটি মেসেজের সম্পূর্ণ বিষয়বস্তু ফেরত দেয়। শুধুমাত্র বিষয় এবং স্নিপেট (মূল অংশ বাদে) অন্তর্ভুক্ত করতে MINIMAL ব্যবহার করুন। শুধুমাত্র মৌলিক মেটাডেটা (মেসেজ আইডি, থ্রেড আইডি, লেবেল, টাইমস্ট্যাম্প এবং আনুমানিক আকার) অন্তর্ভুক্ত করতে METADATA_ONLY ব্যবহার করুন।

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

কার্ল অনুরোধ
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": "get_thread", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

ইনপুট স্কিমা

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

থ্রেড অনুরোধ পান

JSON উপস্থাপনা
{ "threadId": string, "messageFormat": enum (MessageFormat) }

ক্ষেত্র
threadId	string প্রয়োজনীয়। যে থ্রেডটি থেকে ডেটা আনতে হবে তার অনন্য শনাক্তকারী।
messageFormat	enum ( MessageFormat ) ঐচ্ছিক। থ্রেডের মধ্যে ফেরত আসা মেসেজগুলোর ফরম্যাট নির্দিষ্ট করে। ডিফল্ট হিসেবে FULL_CONTENT ব্যবহৃত হয়। দ্রষ্টব্য: MINIMAL ফরম্যাট id, snippet, subject, from, to, cc, date, labelIds ফেরত দেয়। METADATA_ONLY ফরম্যাট id, from, to, cc, date, labelIds ফেরত দেয়। FULL_CONTENT ফরম্যাট id, snippet, subject, from, to, cc, date, labelIds, attachmentIds, plaintextBody, htmlBody, attachments ফেরত দেয়।

বার্তা বিন্যাস

থ্রেডের বার্তাগুলির বিশদ বিবরণের স্তর নিয়ন্ত্রণ করার জন্য ব্যবহৃত এনাম।

এনাম
MESSAGE_FORMAT_UNSPECIFIED	ডিফল্টরূপে FULL_CONTENT ব্যবহৃত হয়।
MINIMAL	বার্তার অংশবিশেষ এবং মূল হেডারগুলো (বিষয়, প্রেরক, প্রাপক, অনুলিপি, তারিখ) ফেরত দেয়।
FULL_CONTENT	প্রতিটি বার্তার সমস্ত তথ্যের পাশাপাশি সম্পূর্ণ মূল বিষয়বস্তুও ফেরত দেয়।
METADATA_ONLY	শুধুমাত্র মেটাডেটা: এতে বিষয়, স্নিপেট, মূল অংশ এবং অ্যাটাচমেন্টের ফাইলের নাম অন্তর্ভুক্ত নয়।

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

বার্তাগুলির তালিকা সম্বলিত থ্রেড।

থ্রেড

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 ], "htmlBody": string, "attachments": [ { object (AttachmentMetadata) } ], "labelIds": [ 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 হয়।
htmlBody	string ইমেইলের HTML কন্টেন্ট, যা শুধুমাত্র তখনই পূরণ করা হবে যদি MessageFormat-এর মান FULL_CONTENT হয়।
attachments[]	object ( AttachmentMetadata ) শুধুমাত্র আউটপুট। অ্যাটাচমেন্টগুলো কেবল তখনই পূরণ করা হবে, যদি MessageFormat-এর মান FULL_CONTENT হয়।
labelIds[]	string মেসেজের সাথে সংযুক্ত লেবেলগুলোর আইডি। এর মধ্যে ব্যবহারকারীর লেবেল এবং INBOX , SPAM , TRASH , UNREAD , STARRED , IMPORTANT , SENT , DRAFT ও CHAT মতো সাধারণ সিস্টেম লেবেলগুলোর আইডি অন্তর্ভুক্ত রয়েছে।

সংযুক্তি মেটাডেটা

JSON উপস্থাপনা
{ "id": string, "mimeType": string, "filename": string }

ক্ষেত্র
id	string শুধুমাত্র আউটপুট। অ্যাটাচমেন্টটির আইডি।
mimeType	string সংযুক্তিটির MIME টাইপ।
filename	string সংযুক্তিটির ফাইলের নাম।

টুল টীকা

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

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

• https://mail.google.com/
• https://www.googleapis.com/auth/gmail.modify
• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/gmail.metadata