MCP Tools Reference: drivemcp.googleapis.com

টুল: search_files

স্ট্রাকচার্ড কোয়েরি ব্যবহার করে ড্রাইভ ফাইল অনুসন্ধান করুন (সিনট্যাক্স: query_term operator values )। ক্লজগুলোকে and , or , not এবং প্রথম বন্ধনী দিয়ে যুক্ত করুন। স্ট্রিং ভ্যালু অবশ্যই সিঙ্গেল-কোটের মধ্যে থাকতে হবে; এর ভেতরে থাকা কোটকে \' দিয়ে এস্কেপ করুন।

অনুসন্ধানের শর্তাবলী ও অপারেটরসমূহ:

  • title (অপশন: contains, =, !=) — ফাইলের শিরোনাম
  • fullText (অপশন: ধারণ করে) — শিরোনাম বা মূল পাঠ্য
  • mimeType (অপশন: contains, =, !=) — MIME টাইপ
  • modifiedTime , viewedByMeTime , createdTime (অপশন: <= , < , = , != , > , >= )। RFC 3339 UTC ব্যবহার করুন, যেমন, 2012-06-04T12:00:00-08:00 । তারিখের ধরণগুলো তুলনীয় নয়।
  • parentId (অপশন: = , != )। ব্যবহারকারীর "My Drive"-এর জন্য 'root' ব্যবহার করুন।
  • owner (অপারেশন: = , != )। অনুরোধকারী ব্যবহারকারীর জন্য 'me' ব্যবহার করুন।
  • sharedWithMe (অপশন: = , != )। মান: true অথবা false ।

অন্যান্য অপারেটর: and , or , not ।

উদাহরণ:

  • title contains 'hello' and title contains 'goodbye'
  • modifiedTime > '2024-01-01T00:00:00Z' and (mimeType contains 'image/' or mimeType contains 'video/')
  • parentId = '1234567'
  • fullText contains 'hello'
  • owner = 'test@example.org'
  • sharedWithMe = true
  • owner = 'me' (ব্যবহারকারীর মালিকানাধীন ফাইলগুলির জন্য)

পৃষ্ঠা বিন্যাস করতে next_page_token ব্যবহার করুন। একটি খালি প্রতিক্রিয়া মানে আর কোনো ফলাফল নেই।

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

কার্ল অনুরোধ 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_files",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

ফাইল অনুসন্ধানের অনুরোধ।

অনুসন্ধান ফাইল অনুরোধ

JSON উপস্থাপনা 
{
  "query": string,

  "pageToken": string

  "pageSize": integer

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

string

অনুসন্ধান ক্যোয়ারি।

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

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

pageToken

string

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

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

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

pageSize

integer

প্রতিটি পৃষ্ঠায় ফেরত দেওয়া ফাইলের সর্বোচ্চ সংখ্যা।

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

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

excludeContentSnippets

boolean

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

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

ফাইল অনুসন্ধানের প্রতিক্রিয়া।

সার্চফাইলসরেসপন্স

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

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

টুল টীকা

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