MCP Tools Reference: drivemcp.googleapis.com

כלי: get_file_metadata

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

אם הקובץ לא נמצא, אפשר לנסות להשתמש בכלים אחרים כמו search_files כדי למצוא את הקובץ שהמשתמש מבקש.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ get_file_metadata.

בקשת 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": "get_file_metadata",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

בקשה לקבלת הקובץ.

GetFileRequest

ייצוג ב-JSON 
{
  "fileId": string,

  "excludeContentSnippets": boolean
}
שדות
fileId

string

חובה. המזהה של הקובץ לאחזור.

שדה איחוד _exclude_content_snippets.

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

boolean

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

סכימת הפלט

משאב קובץ.

קובץ

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