MCP Tools Reference: gmailmcp.googleapis.com

টুল: list_drafts

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

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

এই টুলটি কোয়েরি স্ট্রিং-এর উপর ভিত্তি করে ড্রাফট ফিল্টার করতে পারে এবং পেজিনেশন সমর্থন করে। এটি ড্রাফটগুলোর একটি তালিকা ফেরত দেয়, যার মধ্যে তাদের আইডি এবং বিষয় অন্তর্ভুক্ত থাকে (যদি না view DRAFT_VIEW_METADATA_ONLY তে সেট করা থাকে)। ফলাফল পেজিনেট করার জন্য page_token ব্যবহার করা যেতে পারে। ফলাফলের পরবর্তী পৃষ্ঠাগুলো পেতে, পূর্ববর্তী রেসপন্সে ফেরত আসা page_token টি ব্যবহার করুন।

view প্যারামিটারটি নিয়ন্ত্রণ করে যে রেসপন্সে কোন ফিল্ডগুলো পূরণ করা হবে। ডিফল্টরূপে (অথবা DRAFT_VIEW_FULL ব্যবহার করলে), এটি সম্পূর্ণ কন্টেন্ট ফেরত দেয়। সাবজেক্ট এবং বডির মতো সংবেদনশীল কন্টেন্ট বাদ দিতে DRAFT_VIEW_METADATA_ONLY ব্যবহার করুন।

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

ইনপুট স্কিমা

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

তালিকা খসড়া অনুরোধ

JSON উপস্থাপনা
{ "pageSize": integer "pageToken": string "query": string "view": enum (DraftView) }

ক্ষেত্র
ইউনিয়ন ফিল্ড _page_size . _page_size নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
pageSize	integer ঐচ্ছিক। ফেরত দেওয়ার জন্য খসড়ার সর্বোচ্চ সংখ্যা। নির্দিষ্ট না করা হলে, ডিফল্ট হিসেবে ২০ ধরা হবে। সর্বোচ্চ অনুমোদিত মান হলো ৫০।
ইউনিয়ন ফিল্ড _page_token . _page_token নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
pageToken	string ঐচ্ছিক। ফলাফলের পরবর্তী পৃষ্ঠা আনার জন্য পূর্ববর্তী list_drafts কল থেকে প্রাপ্ত একটি টোকেন। প্রথম পৃষ্ঠাটি আনতে এটি খালি রাখুন। এটি প্রধানত পেজিনেশনের জন্য ব্যবহৃত হয়, যাতে পূর্ববর্তী ListDraft কল যেখানে শেষ হয়েছিল সেখান থেকে ফলাফল আনা চালিয়ে যাওয়া যায়, বিশেষ করে যখন কোয়েরির সাথে মিলে যাওয়া ড্রাফটের সংখ্যা page_size সীমা অতিক্রম করে।
ইউনিয়ন ফিল্ড _query . _query নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
query	string উদাহরণ: subject:OneMCP Update from:[e-mail] to:[e-mail] AND newer_than:7d project proposal has:attachment is:unread একটি স্পেস বা ড্যাশ ( - ) দুটি সংখ্যাকে আলাদা করে, আর একটি ডট ( . ) দশমিক সংখ্যা বোঝায়। উদাহরণস্বরূপ, 01.2047-100 দুটি সংখ্যা হিসেবে গণ্য করা হয়: 01.2047 এবং 100 । দ্রষ্টব্য: যদি আমরা নিশ্চিত করতে চাই যে কোয়েরিটির সমস্ত ড্রাফট ফেরত আসবে, তাহলে আমরা টুলটিতে বারবার কল করে ফলাফলগুলোকে পেজিনেট করতে পারি, যতক্ষণ না রেসপন্সে ড্রাফটের একটি খালি তালিকা থাকে।
ইউনিয়ন ফিল্ড _view . _view নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
view	enum ( DraftView ) ঐচ্ছিক। ড্রাফট তালিকায় থাকা ড্রাফটগুলোর জন্য পূরণ করা ফিল্ডগুলো এটি নিয়ন্ত্রণ করে। ডিফল্টরূপে (অথবা DRAFT_VIEW_FULL ব্যবহার করলে), এটি সম্পূর্ণ বিষয়বস্তু ফেরত দেয়, যার মধ্যে ড্রাফট আইডি, থ্রেডআইডি, প্রাপক, সিসি, বিসিসি, তারিখ, বিষয় এবং মূল অংশ থাকে। বিষয় এবং মূল অংশ বাদ দিতে DRAFT_VIEW_METADATA_ONLY ব্যবহার করুন।

ড্রাফটভিউ

ListDrafts রেসপন্সে ড্রাফটগুলোর জন্য পূরণকৃত ফিল্ডগুলো নিয়ন্ত্রণ করার Enum।

এনাম
DRAFT_VIEW_UNSPECIFIED	পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্য রক্ষার জন্য DRAFT_VIEW_FULL-এর সাথে ম্যাপ করা হয়েছে।
DRAFT_VIEW_METADATA_ONLY	শুধুমাত্র মেটাডেটা: এতে বিষয়, প্লেইনটেক্সট বডি, এইচটিএমএল বডি অন্তর্ভুক্ত নয়।
DRAFT_VIEW_FULL	মেটাডেটা + ইউজিসি (ডিফল্ট আচরণ)।

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

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

তালিকা খসড়া প্রতিক্রিয়া

JSON উপস্থাপনা
{ "drafts": [ { object (Draft) } ], "nextPageToken": string }

ক্ষেত্র
drafts[]	object ( Draft ) খসড়াগুলোর তালিকা।
nextPageToken	string একটি টোকেন যা পরবর্তী কলে ড্রাফটের পরবর্তী পৃষ্ঠা আনার জন্য ব্যবহার করা যেতে পারে। যদি কোয়েরির সাথে মিলে যাওয়া ড্রাফটের সংখ্যা page_size সীমা অতিক্রম করে, তাহলে রেসপন্সে একটি next_page_token থাকবে। ফলাফলের পরবর্তী পৃষ্ঠা আনতে, পরবর্তী ListDraftsRequest এর page_token ফিল্ডে এই টোকেনটি পাস করুন।

খসড়া

JSON উপস্থাপনা
{ "id": string, "subject": string, "threadId": string, "toRecipients": [ string ], "ccRecipients": [ string ], "bccRecipients": [ string ], "plaintextBody": string, "date": string, "htmlBody": string }

ক্ষেত্র
id	string খসড়া রিসোর্সটির অনন্য শনাক্তকারী।
subject	string খসড়া বার্তাটির বিষয়বস্তু।
threadId	string এই খসড়াটি যে থ্রেডের অন্তর্গত, তার আইডি।
toRecipients[]	string হেডার থেকে সংগৃহীত 'To' প্রাপকের ইমেল ঠিকানার তালিকা।
ccRecipients[]	string হেডার থেকে সংগৃহীত 'Cc' প্রাপকদের ইমেল ঠিকানার তালিকা।
bccRecipients[]	string হেডার থেকে সংগৃহীত 'Bcc' প্রাপকদের ইমেল ঠিকানার তালিকা।
plaintextBody	string সাধারণ টেক্সট মূল বিষয়বস্তু, যদি উপলব্ধ থাকে।
date	string খসড়ার তারিখ ISO 8601 ফরম্যাটে (YYYY-MM-DD)।
htmlBody	string খসড়াটির HTML মূল বিষয়বস্তু, যদি উপলব্ধ থাকে।

টুল টীকা

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

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

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

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