MCP Tools Reference: gmailmcp.googleapis.com

টুল: create_draft

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

এই টুলটি ইনপুট হিসেবে প্রাপকের ঠিকানা, একটি বিষয় এবং মূল বার্তার বিষয়বস্তু গ্রহণ করে। যদি বিদ্যমান কোনো বার্তার প্রত্যুত্তর হিসেবে খসড়াটি তৈরি করা হয়, তবে মূল বার্তার আইডিটি `replyToMessageId` ফিল্ডে টুলটিতে পাঠাতে হবে।

খসড়া বার্তাটির শুধুমাত্র অনন্য আইডি (id) ফেরত দেয়।

সীমাবদ্ধতা: অ্যাটাচমেন্ট সহ ড্রাফট তৈরি করার সুবিধাটি এখনও নেই।

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

ইনপুট স্কিমা

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

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

JSON উপস্থাপনা 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
ক্ষেত্র
to[]

string

ঐচ্ছিক। ইমেল ড্রাফটের প্রধান প্রাপকগণ। প্রতিটি স্ট্রিং অবশ্যই একটি বৈধ সাধারণ ইমেল ঠিকানা হতে হবে (যেমন, "user@example.com")। "Name email@example.com " ফরম্যাটটি এই টুল দ্বারা সমর্থিত নয়।

cc[]

string

ঐচ্ছিক। ইমেল ড্রাফটের কার্বন কপি প্রাপকগণ। প্রতিটি স্ট্রিং অবশ্যই একটি বৈধ সাধারণ ইমেল ঠিকানা হতে হবে (যেমন, "user@example.com")। "Name email@example.com " ফরম্যাটটি এই টুল দ্বারা সমর্থিত নয়।

bcc[]

string

ঐচ্ছিক। ইমেল খসড়ার ব্লাইন্ড কার্বন কপি প্রাপকগণ। প্রতিটি স্ট্রিং অবশ্যই একটি বৈধ সাধারণ ইমেল ঠিকানা হতে হবে (যেমন, "user@example.com")। "Name email@example.com " ফরম্যাটটি এই টুল দ্বারা সমর্থিত নয়।

subject

string

ঐচ্ছিক। ইমেইলের বিষয়। প্রদান করা না হলে এটি খালি থাকবে।

body

string

ঐচ্ছিক। ইমেল খসড়ার মূল বিষয়বস্তু। যদি html_body-ও প্রদান করা হয়, তবে এই ক্ষেত্রটিকে সাধারণ পাঠ্যের বিকল্প হিসেবে গণ্য করা হবে।

htmlBody

string

ইমেইল ড্রাফটের এইচটিএমএল (HTML) কন্টেন্ট। যদি এটি প্রদান করা হয়, তবে এটি ইমেইলের রিচ-টেক্সট সংস্করণ হিসেবে ব্যবহৃত হবে।

replyToMessageId

string

ঐচ্ছিক। যে বার্তার উত্তর দিতে হবে তার আইডি। যদি এটি প্রদান করা হয়, তবে এটি ইমেল ড্রাফটের জন্য রিপ্লাই-টু মেসেজ আইডি হিসেবে ব্যবহৃত হবে এবং body ও html_body মূল বার্তার বডির সাথে যুক্ত করা হবে।

attachments[]

object ( Attachment )

ঐচ্ছিক। ইমেইলে যে অ্যাটাচমেন্টগুলো যুক্ত করতে হবে। মেসেজে থাকা অ্যাটাচমেন্টগুলোর সম্মিলিত সাইজ ২৫ মেগাবাইটের বেশি হতে পারবে না। যদি ২৫ মেগাবাইটের চেয়ে বড় ফাইল পাঠানোর প্রয়োজন হয়, তবে প্রথমে ফাইলটি ড্রাইভে আপলোড করুন এবং তারপর ড্রাইভ লিঙ্কটি `body` বা `html_body`-তে যুক্ত করুন।

সংযুক্তি

JSON উপস্থাপনা 
{
  "id": string,
  "filename": string,
  "mimeType": string,
  "content": string,
  "inline": boolean
}
ক্ষেত্র
id

string

ঐচ্ছিক। শুধুমাত্র আউটপুট হিসেবে প্রদর্শিত হয়। উপস্থিত থাকলে, এতে একটি বাহ্যিক অ্যাটাচমেন্টের আইডি থাকে যা একটি পৃথক GetMessageAttachment অনুরোধের মাধ্যমে পুনরুদ্ধার করা যেতে পারে।

filename

string

ঐচ্ছিক। যে ফাইলটি সংযুক্ত করতে হবে তার নাম, যেমন "invoice.pdf"। ইনলাইন অ্যাটাচমেন্টের ক্ষেত্রে, এটি কন্টেন্ট-আইডি তৈরির জন্য ব্যবহৃত হয়। সাধারণ অ্যাটাচমেন্টের জন্য, ইমেল ক্লায়েন্টদের কাছে ফাইলের নাম নির্দিষ্ট করতে 'filename' ব্যবহৃত হয়। এটি প্রদান করা না হলে, অ্যাটাচমেন্টটি নামবিহীন অবস্থায় আসতে পারে।

mimeType

string

ঐচ্ছিক। কন্টেন্ট বা মিডিয়া টাইপ নির্দেশকারী ফিল্ডটিতে অবশ্যই IANA MIME টাইপ ব্যবহার করতে হবে, যা হলো https://www.iana.org/assignments/media-types/media-types.xhtml । এটি প্রদান করা না হলে, ডিফল্ট হিসেবে 'application/octet-stream' ব্যবহৃত হবে।

content

string ( bytes format)

প্রয়োজনীয়। সংযুক্তিটির বেস৬৪-এনকোডেড বিষয়বস্তু।

একটি বেস৬৪-এনকোডেড স্ট্রিং।

inline

boolean

ঐচ্ছিক। যদি 'true' হয়, তাহলে এই অ্যাটাচমেন্টটি ইনলাইন হিসেবে গণ্য হবে। ইনলাইন অ্যাটাচমেন্ট হলো এমন একটি কন্টেন্ট যা ডাউনলোডের জন্য আলাদা ফাইল হিসেবে তালিকাভুক্ত না হয়ে, একটি HTML ইমেলের মূল অংশে প্রদর্শিত হওয়ার জন্য তৈরি করা হয়। যদি 'false' বা অনুপস্থিত থাকে, তবে এটি ডিফল্টরূপে 'false' হিসেবে গণ্য হবে এবং এটিকে একটি সাধারণ অ্যাটাচমেন্ট হিসেবে বিবেচনা করা হবে।

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

একটি খসড়ার বিবরণ।

খসড়া

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