MCP Tools Reference: drivemcp.googleapis.com

כלי: search_files

אפשר להשתמש בכלי הזה כדי לחפש קבצים ב-Drive באמצעות שאילתה מובנית.

בשדה query צריך להשתמש באופרטורים של שאילתות חיפוש.

מחרוזת שאילתה מכילה את שלושת החלקים הבאים: query_term operator values כאשר:

  • ‫query_term הוא מונח השאילתה או השדה לחיפוש.
  • ‫operator מציין את התנאי למונח השאילתה.
  • values הם הערכים הספציפיים שבהם צריך להשתמש כדי לסנן את תוצאות החיפוש.

מונחי השאילתה

בטבלה הבאה מפורטים מונחי שאילתה תקינים והתיאורים שלהם:

מונח שאילתה אופרטורים תקינים שימוש
title contains,‏ =,‏ != שם הקובץ. מקיפים במירכאות בודדות ('). משתמשים בתו בריחה \' כדי להוסיף מירכאות בודדות בשאילתות, כמו 'Valentine\'s Day'.
fullText contains אם הערך title או הטקסט בתוכן הקובץ תואמים. מקיפים במירכאות בודדות ('). משתמשים בתו בריחה \' כדי להוסיף מירכאות בודדות בשאילתות, כמו 'Valentine\'s Day'.
mimeType contains,‏ =,‏ != סוג ה-MIME של הקובץ. מקיפים במירכאות בודדות ('). משתמשים בתו בריחה \' כדי להוסיף מירכאות בודדות בשאילתות, כמו 'Valentine\'s Day'.
modifiedTime <=,‏ <,‏ =,‏ !=,‏ >,‏ >= התאריך של השינוי האחרון בקובץ. פורמט RFC 3339, אזור הזמן שמוגדר כברירת מחדל הוא UTC, למשל 2012-06-04T12:00:00-08:00. אי אפשר להשוות בין שדות מהסוג date.
viewedByMeTime <=,‏ <,‏ =,‏ !=,‏ >,‏ >= התאריך שבו המשתמש צפה לאחרונה בקובץ. פורמט RFC 3339, אזור הזמן שמוגדר כברירת מחדל הוא UTC, למשל 2012-06-04T12:00:00-08:00. אי אפשר להשוות בין שדות מהסוג date.
parentId =, != האם ההורה שווה למזהה שצוין. אפשר להשתמש ב-root כדי לציין את התיקייה 'האחסון שלי' של המשתמש, שמשמשת כהיררכיה הראשית שלו.
owner =, != המשתמש שהוא הבעלים של הקובץ. אפשר להשתמש ב-me כדי לציין את המשתמש ששולח את הבקשה.
sharedWithMe =, != קבצים באוסף 'קבצים ששותפו איתי' של המשתמש. כל המשתמשים בקובץ נמצאים ברשימת בקרת הגישה (ACL) של הקובץ. יכול להיות true או false.
createdTime <=,‏ <,‏ =,‏ !=,‏ >,‏ >= התאריך שבו הקובץ נוצר. צריך להשתמש בפורמט RFC 3339, אזור הזמן שמוגדר כברירת מחדל הוא UTC, למשל 2012-06-04T12:00:00-08:00.

אופרטורים של שאילתות

בטבלה הבאה מפורטים אופרטורים חוקיים של שאילתות:

מפעיל שימוש
contains התוכן של מחרוזת אחת מופיע במחרוזת השנייה.
= התוכן של מחרוזת או ערך בוליאני שווה לתוכן של המחרוזת או הערך הבוליאני השני.
!= התוכן של מחרוזת או של ערך בוליאני לא שווה לתוכן של המחרוזת או הערך השני.
< ערך אחד קטן מערך אחר.
<= ערך קטן מערך אחר או שווה לו.
> ערך אחד גדול יותר מערך אחר.
>= ערך גדול מערך אחר או שווה לו.
in רכיב נכלל באוסף.
and החזרת פריטים שתואמים לשתי השאילתות.
or החזרת פריטים שתואמים לאחת מהשאילתות.
not שלילת שאילתת חיפוש.
has אוסף מכיל רכיב שתואם לפרמטרים.

דוגמאות לשאילתות:

  • 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 כדי להפעיל את כלי ה-MCP‏ search_files.

בקשת Curl 
curl --location 'https://drivemcp.googleapis.com/mcp' \
--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 MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת קלט

בקשה לחיפוש קבצים.

SearchFilesRequest

ייצוג 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

אם הערך הוא true, קטע התוכן לא ייכלל בתשובה.

סכימת פלט

תשובה לחיפוש קבצים.

SearchFilesResponse

ייצוג 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
}
שדות
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

קטע מידע שנוצר על ידי AI לגבי התוכן של הקובץ.

שדה איחוד _view_url.

הערך _view_url יכול להיות רק אחד מהבאים:
viewUrl

string

כתובת ה-URL לצפייה בקובץ.

שדה איחוד _shared_with_me_time.

הערך _shared_with_me_time יכול להיות רק אחד מהבאים:
sharedWithMeTime

string (Timestamp format)

השעה שבה הקובץ שותף עם מגיש הבקשה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-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 עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-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 עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-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 עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

שדה איחוד _owner.

הערך _owner יכול להיות רק אחד מהבאים:
owner

string

כתובת האימייל של הבעלים של הקובץ.

חותמת זמן

ייצוג JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ב-1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של משך הזמן בננו-שניות, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

הערות על כלי

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌