MCP Tools Reference: drivemcp.googleapis.com

টুল: list_recent_files

ব্যবহারকারী কর্তৃক নির্দিষ্ট করা সাজানোর ক্রম অনুসারে সাম্প্রতিক ফাইলগুলি খুঁজে পেতে এই টুলটি ব্যবহার করুন। ডিফল্ট সাজানোর ক্রম হলো recency ।

সমর্থিত সর্ট অর্ডারগুলি হলো:

  • recency : ফাইলটির তারিখ-সময় ক্ষেত্র থেকে প্রাপ্ত সর্বশেষ সময়চিহ্ন।
  • lastModified : ফাইলটি সর্বশেষ কবে পরিবর্তন করা হয়েছিল।
  • lastModifiedByMe : ব্যবহারকারী কর্তৃক ফাইলটি সর্বশেষ পরিবর্তনের সময়।

ডিফল্ট পেজ সাইজ হলো ১০। ফলাফলগুলোর মধ্যে পেজিনেট করার জন্য next_page_token ব্যবহার করুন।

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

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

ইনপুট স্কিমা

ফাইলগুলির তালিকা করার অনুরোধ।

ফাইল তালিকা অনুরোধ

JSON উপস্থাপনা 
{

  "orderBy": string

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
ক্ষেত্র

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

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

orderBy

string

ফাইলগুলোর সাজানোর ক্রম।

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

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

pageToken

string

পেজিনেশনের জন্য ব্যবহৃত পেজ টোকেন।

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

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

pageSize

integer

ফেরত দেওয়ার জন্য ফাইলের সর্বোচ্চ সংখ্যা।

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

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

excludeContentSnippets

boolean

যদি সত্য হয়, তাহলে কন্টেন্ট স্নিপেটটি রেসপন্স থেকে বাদ দেওয়া হবে।

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

ফাইল তালিকা সংক্রান্ত প্রতিক্রিয়া।

ListFilesResponse

JSON উপস্থাপনা 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
ক্ষেত্র
files[]

object ( File )

ফাইলগুলির তালিকা।

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

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

nextPageToken

string

পরবর্তী পৃষ্ঠার টোকেন।

ফাইল

JSON উপস্থাপনা 
{
  "id": string,
  "title": string,
  "parentId": string,

  "mimeType": string

  "fileSize": string

  "description": string

  "fileExtension": string

  "contentSnippet": string

  "viewUrl": string

  "sharedWithMeTime": string

  "createdTime": string

  "modifiedTime": string

  "viewedByMeTime": string

  "owner": string

  "canAddChildren": boolean
}
ক্ষেত্র
id

string

যে ফাইলটি আনা হয়েছিল তার আইডি।

title

string

ফাইলটির শিরোনাম।

parentId

string

ফাইলটির প্যারেন্টের (ঐচ্ছিক) আইডি।

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

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

mimeType

string

ফাইলটির মাইম টাইপ।

ইউনিয়ন ফিল্ড _file_size ।

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

fileSize

string ( int64 format)

ফাইলটির আকার বাইটে।

ইউনিয়ন ফিল্ডের _description ।

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

description

string

ফাইলটির বিবরণ।

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

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

fileExtension

string

ফাইলটির মূল ফাইল এক্সটেনশন, এটি শুধুমাত্র ড্রাইভে সংরক্ষিত কন্টেন্টযুক্ত ফাইলগুলোর ক্ষেত্রেই পূরণ করা হয়।

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

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

contentSnippet

string

ফাইলটির বিষয়বস্তু সম্পর্কে একটি সংক্ষিপ্ত অংশ তৈরি করা হয়েছে।

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

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

viewUrl

string

ফাইলটি দেখার জন্য ইউআরএল।

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

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

sharedWithMeTime

string ( Timestamp format)

যে সময়ে ফাইলটি অনুরোধকারীর সাথে শেয়ার করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

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

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

createdTime

string ( Timestamp format)

ফাইলটি তৈরি হওয়ার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

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

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

modifiedTime

string ( Timestamp format)

সর্বশেষ যে সময়ে ফাইলটি পরিবর্তন করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

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

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

viewedByMeTime

string ( Timestamp format)

অনুরোধকারী কর্তৃক ফাইলটি সর্বশেষ দেখার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

ইউনিয়ন ক্ষেত্রের _owner ।

_owner নিম্নলিখিতদের মধ্যে কেবল একজন হতে পারেন:

owner

string

ফাইলটির মালিকের ইমেইল ঠিকানা।

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

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

canAddChildren

boolean

অনুরোধকারী এই ফোল্ডারে চাইল্ড ফাইল যোগ করতে পারবেন কিনা। যেগুলো ফোল্ডার নয়, সেগুলোর ক্ষেত্রে এটি সর্বদা মিথ্যা।

টাইমস্ট্যাম্প

JSON উপস্থাপনা 
{
  "seconds": string,
  "nanos": integer
}
ক্ষেত্র
seconds

string ( int64 format)

এটি ইউনিক্স ইপক 1970-01-01T00:00:00Z থেকে UTC সময়ের সেকেন্ড নির্দেশ করে। এর মান অবশ্যই -62135596800 থেকে 253402300799 (উভয় মানসহ) এর মধ্যে হতে হবে (যা 0001-01-01T00:00:00Z থেকে 9999-12-31T23:59:59Z পর্যন্ত সময়কালের সমতুল্য)।

nanos

integer

ন্যানোসেকেন্ড রেজোলিউশনে সেকেন্ডের অঋণাত্মক ভগ্নাংশ। এই ক্ষেত্রটি হলো সময়কালের ন্যানোসেকেন্ড অংশ, সেকেন্ডের বিকল্প নয়। ভগ্নাংশসহ ঋণাত্মক সেকেন্ডের মানগুলোর ক্ষেত্রেও ন্যানোর মান অবশ্যই অঋণাত্মক হতে হবে, যা সময়ের সাথে সাথে গণনা করে। এর মান অবশ্যই ০ থেকে ৯৯৯,৯৯৯,৯৯৯-এর মধ্যে হতে হবে (উভয় সংখ্যাসহ)।

টুল টীকা

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

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly