MCP Tools Reference: drivemcp.googleapis.com

ابزار: search_files

جستجوی فایل‌های Drive با استفاده از یک پرس‌وجوی ساختاریافته (syntax: query_term operator values ). عبارات را با and ، or ، not و پرانتز ترکیب کنید. مقادیر رشته‌ای باید درون علامت نقل قول تکی قرار گیرند؛ از علامت نقل قول جاسازی‌شده به صورت \' استفاده کنید.

عبارات و عملگرهای پرس‌وجو:

  • title (ops: contains, =, !=) — عنوان فایل
  • fullText (ops: contains) — عنوان یا متن بدنه
  • mimeType (ops: contains, =, !=) — نوع MIME
  • modifiedTime ، viewedByMeTime ، createdTime (ops: <= ، < ، = ، != ، > ، >= ). از RFC 3339 UTC استفاده کنید، مثلاً 2012-06-04T12:00:00-08:00 . انواع تاریخ قابل مقایسه نیستند.
  • parentId (ops: = , != ). برای "My Drive" کاربر 'root' استفاده کنید.
  • owner (ops: = , != ). از '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

نوع MIME فایل.

فیلد یونیون _file_size .

_file_size می‌تواند فقط یکی از موارد زیر باشد:

fileSize

string ( int64 format)

اندازه فایل بر حسب بایت.

فیلد اتحادیه _description .

_description فقط می‌تواند یکی از موارد زیر باشد:

description

string

توضیحات فایل.

فیلد یونیون _file_extension .

_file_extension ‎‏ فقط می‌تواند یکی از موارد زیر باشد:

fileExtension

string

پسوند اصلی فایل، این فقط برای فایل‌هایی که محتوای آنها در Drive ذخیره شده است، استفاده می‌شود.

فیلد یونیون _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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌