MCP Tools Reference: drivemcp.googleapis.com

כלי: search_files

חיפוש קבצים ב-Drive באמצעות שאילתה מובנית (תחביר: query_term operator values). אפשר לשלב בין סעיפים באמצעות and,‏ or,‏ not וסוגריים. ערכי מחרוזת צריכים להיות מוקפים במירכאות בודדות. צריך להוסיף תו בריחה למירכאות מוטמעות בצורה הבאה: \'.

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

  • ‫title (ops: contains, =, !=) — file title
  • ‫fullText (ops: contains) – כותרת או תוכן ההודעה
  • ‫mimeType (ops: contains, =, !=) — סוג MIME
  • ‫modifiedTime, viewedByMeTime, createdTime (ops: <=, <, =, !=, >, >=). צריך להשתמש ב-UTC לפי RFC 3339, לדוגמה: 2012-06-04T12:00:00-08:00. אי אפשר להשוות בין סוגי התאריכים.
  • ‫parentId (פעולות: =, !=). משתמשים ב-'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 כדי להפעיל את כלי ה-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

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

  "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

כתובת ה-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

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

שדה איחוד _can_add_children.

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

boolean

אם מגיש הבקשה יכול להוסיף ילדים לתיקייה הזו. הערך הזה תמיד false עבור סוגים שאינם תיקיות.

חותמת זמן

ייצוג ב-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, כולל.

הערות על כלים

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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