MCP Tools Reference: gmailmcp.googleapis.com

টুল: get_message

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

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

যখন আপনার কাছে কোনো একটি নির্দিষ্ট ইমেলের মেসেজ আইডি আগে থেকেই জানা থাকে, তখন সেই ইমেলটি পুঙ্খানুপুঙ্খভাবে পরীক্ষা করার জন্য এই টুলটি ব্যবহার করুন। যদি ব্যবহারকারী কোনো একটি নির্দিষ্ট ইমেল বিস্তারিতভাবে পড়তে, কোনো বার্তার সঠিক শব্দচয়ন যাচাই করতে, বা একটিমাত্র ইমেলের অ্যাটাচমেন্টের মেটাডেটা পরীক্ষা করতে চান, তবে এটিই সঠিক টুল। এটি সম্পূর্ণ কথোপকথন পুনরুদ্ধার করা বা পারস্পরিক আলোচনার থ্রেড দেখার জন্য উপযুক্ত নয়; সেক্ষেত্রে 'get_thread' টুলটি ব্যবহার করুন। এর প্রধান সূচকগুলোর মধ্যে রয়েছে, যদি ব্যবহারকারী পূর্ববর্তী অনুসন্ধানে প্রাপ্ত কোনো নির্দিষ্ট মেসেজ আইডির সম্পূর্ণ বিষয়বস্তু জানতে চান, অথবা যদি কোয়েরিটি সম্পূর্ণ থ্রেডের পরিবর্তে একটি নির্দিষ্ট ইমেল পুঙ্খানুপুঙ্খভাবে পরীক্ষা করতে বলে। ব্যবহারকারীর জন্য কিছু উদাহরণমূলক অনুরোধ হলো: "মেসেজ আইডি 18f123456789abcd-এর সম্পূর্ণ টেক্সটটি দিন।", "ওই থ্রেডে অ্যালিসের পাঠানো সর্বশেষ মেসেজটি পড়ুন।", এবং "আমি এইমাত্র এইচআর-এর কাছ থেকে যে ইমেলটি পেয়েছি, সেটিতে অ্যাটাচমেন্টের নামগুলো কী কী?"

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

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

ইনপুট স্কিমা

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

GetMessageRequest

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

ক্ষেত্র
messageId	string প্রয়োজনীয়। যে বার্তাটি আনতে হবে তার অনন্য শনাক্তকারী।
messageFormat	enum ( MessageFormat ) ঐচ্ছিক। ফেরত আসা বার্তার ফরম্যাট নির্দিষ্ট করে। ডিফল্ট হলো FULL_CONTENT।

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

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

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

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

একটি থ্রেডের মধ্যে বার্তা।

বার্তা

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