MCP Tools Reference: gmailmcp.googleapis.com

টুল: list_drafts

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

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

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

কার্ল অনুরোধ 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--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
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _page_size .

_page_size নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

pageSize

integer

ঐচ্ছিক। ফেরত দেওয়ার জন্য খসড়ার সর্বোচ্চ সংখ্যা। নির্দিষ্ট না করা হলে, ডিফল্ট হিসেবে ২০ ধরা হবে। সর্বোচ্চ অনুমোদিত মান হলো ৫০।

ইউনিয়ন ফিল্ড _page_token .

_page_token নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

pageToken

string

ঐচ্ছিক। ফলাফলের পরবর্তী পৃষ্ঠা আনার জন্য পূর্ববর্তী list_drafts কল থেকে প্রাপ্ত একটি টোকেন। প্রথম পৃষ্ঠাটি আনতে এটি খালি রাখুন। এটি প্রধানত পেজিনেশনের জন্য ব্যবহৃত হয়, যাতে পূর্ববর্তী ListDraft কল যেখানে শেষ হয়েছিল সেখান থেকে ফলাফল আনা চালিয়ে যাওয়া যায়, বিশেষ করে যখন কোয়েরির সাথে মিলে যাওয়া ড্রাফটের সংখ্যা page_size সীমা অতিক্রম করে।

ইউনিয়ন ফিল্ড _query .

_query নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

query

string

উদাহরণ: "বিষয়:OneMCP আপডেট" "প্রেরক: gduser1@workspacesamples.dev " "প্রাপক: gduser2@workspacesamples.dev এবং ৭ দিনের চেয়ে নতুন" "প্রকল্প প্রস্তাবে সংযুক্তি আছে" "অপঠিত"

একটি স্পেস বা ড্যাশ ( - ) দুটি সংখ্যাকে আলাদা করে, আর একটি ডট ( . ) দশমিক সংখ্যা বোঝায়। উদাহরণস্বরূপ, 01.2047-100 দুটি সংখ্যা হিসেবে গণ্য করা হয়: 01.2047 এবং 100 ।

দ্রষ্টব্য: যদি আমরা নিশ্চিত করতে চাই যে কোয়েরিটির সমস্ত ড্রাফট ফেরত আসবে, তাহলে আমরা টুলটিতে বারবার কল করে ফলাফলগুলোকে পেজিনেট করতে পারি, যতক্ষণ না রেসপন্সে ড্রাফটের একটি খালি তালিকা থাকে।

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

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
}
ক্ষেত্র
id

string

খসড়া রিসোর্সটির অনন্য শনাক্তকারী।

subject

string

খসড়া বার্তাটির বিষয়বস্তু।

threadId

string

এই খসড়াটি যে থ্রেডের অন্তর্গত, তার আইডি।

toRecipients[]

string

হেডার থেকে সংগৃহীত 'To' প্রাপকের ইমেল ঠিকানার তালিকা।

ccRecipients[]

string

হেডার থেকে সংগৃহীত 'Cc' প্রাপকদের ইমেল ঠিকানার তালিকা।

bccRecipients[]

string

হেডার থেকে সংগৃহীত 'Bcc' প্রাপকদের ইমেল ঠিকানার তালিকা।

plaintextBody

string

সাধারণ টেক্সট মূল বিষয়বস্তু, যদি উপলব্ধ থাকে।

date

string

খসড়ার তারিখ ISO 8601 বিন্যাসে (YYYY-MM-DD)।

টুল টীকা

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