ابزار: search_files
جستجوی فایلهای Drive بااستفاده از پُرسمان ساختاریافته (نحو: query_term operator values). ترکیب بندها با and، or، not، و پرانتز. مقادیر رشتهای باید در گیومه تکی قرار بگیرند؛ گیومههای جاسازیشده را بهصورت \' گریز دهید.
عبارتها و اپراتورهای پُرسمان:
-
title(ops: contains, =, !=) — عنوان فایل -
fullText(ops: contains) — عنوان یا نوشتار اصلی mimeType(ops: contains, =, !=) — MIME typemodifiedTime،viewedByMeTime،createdTime(عملیات:<=،<،=،!=،>،>=). از RFC 3339 UTC استفاده کنید، مثلاً2012-06-04T12:00:00-08:00. انواع تاریخ قابلمقایسه نیستند.parentId(ops:=,!=). Use'root'for the user's "My Drive".-
owner(ops:=،!=). از'me'برای کاربر درخواستکننده استفاده کنید. -
sharedWithMe(ops:=،!=). مقادیر: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 = trueowner = 'me'(برای فایلهایی که کاربر مالک آنها است)
از next_page_token برای صفحهبندی استفاده کنید. پاسخ خالی یعنی نتیجه دیگری وجود ندارد.
نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار MCP search_files را نشان میدهد.
| درخواست Curl |
|---|
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": "search_files", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
طرحواره ورودی
درخواست جستجوی فایلها.
SearchFilesRequest
| نمایش JSON |
|---|
{ "query": string, "pageToken": string, "pageSize": integer, "excludeContentSnippets": boolean } |
| فیلدها | |
|---|---|
query |
پرسمان جستجو. |
فیلد اتحادیه
|
|
pageToken |
نشان صفحه برای استفاده در صفحهبندی. |
فیلد اتحادیه
|
|
pageSize |
حداکثر تعداد فایلها برای برگرداندن در هر صفحه. |
فیلد اتحادیه
|
|
excludeContentSnippets |
اگر درست باشد، گزیده محتوا از پاسخ حذف خواهد شد. |
طرح برونداد
پاسخ به فایلهای جستجو.
SearchFilesResponse
| نمایش JSON |
|---|
{
"files": [
{
object ( |
| فیلدها | |
|---|---|
files[] |
فقط خروجی. فهرست فایلها. |
فیلد اتحادیه
|
|
nextPageToken |
کد صفحه بعدی. |
فایل
| نمایش 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 |
شناسه فایلی که واکشی شده است. |
title |
عنوان فایل. |
parentId |
شناسه (اختیاری) والد فایل. |
فیلد اتحادیه
|
|
mimeType |
نوع رسانه فایل. |
فیلد اتحادیه
|
|
fileSize |
اندازه فایل برحسب بایت. |
فیلد اتحادیه
|
|
description |
شرح فایل. |
فیلد اتحادیه
|
|
fileExtension |
پسوند فایل اصلی فایل، این فقط برای فایلهایی با محتوای ذخیرهشده در Drive پر میشود. |
فیلد اتحادیه
|
|
contentSnippet |
گزیده تولیدشده درباره محتوای فایل. |
فیلد اتحادیه
|
|
viewUrl |
نشانی وب برای مشاهده فایل. |
فیلد اتحادیه
|
|
sharedWithMeTime |
زمانی که فایل با درخواستکننده همرسانی شده است. از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
فیلد اتحادیه
|
|
createdTime |
زمانی که فایل ایجاد شده است. از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
فیلد اتحادیه
|
|
modifiedTime |
آخرین زمانی که فایل اصلاح شده است. از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
فیلد اتحادیه
|
|
viewedByMeTime |
آخرین باری که فایل توسط درخواستکننده مشاهده شده است. از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
فیلد اتحادیه
|
|
owner |
نشانی ایمیل مالک فایل. |
فیلد اتحادیه
|
|
canAddChildren |
آیا درخواستکننده میتواند فرزندان را به این پوشه اضافه کند. این مقدار برای انواع غیرپوشه همیشه نادرست است. |
مُهر زمان
| نمایش JSON |
|---|
{ "seconds": string, "nanos": integer } |
| فیلدها | |
|---|---|
seconds |
نشاندهنده ثانیههای ساعت هماهنگ جهانی از تاریخ یونیکس 1970-01-01T00:00:00Z است. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که با 0001-01-01T00:00:00Z تا 9999-12-31T23:59:59Z مطابقت دارد). |
nanos |
کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه مدت است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان مقادیر نانو غیرمنفی داشته باشند که در زمان به جلو شمارش میشوند. باید بین ۰ و ۹۹۹٬۹۹۹٬۹۹۹ باشد. |
حاشیهنویسیهای ابزار
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
دامنههای مجوز
به یکی از دامنههای OAuth زیر نیاز دارد:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.meet.readonlyhttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.metadata.readonlyhttps://www.googleapis.com/auth/drive.photos.readonlyhttps://www.googleapis.com/auth/drive.readonly