MCP Tools Reference: drivemcp.googleapis.com

כלי: copy_file

אפשר להשתמש בכלי הזה כדי להעתיק קובץ קיים ב-Google Drive. הכלי מאפשר לציין כותרת חדשה ותיקיית אב להעתקה. אם לא מציינים את השם, השם של העותק יהיה 'עותק של {השם המקורי}'. אם לא מציינים את תיקיית ההורה, העותק ייווצר באותה תיקייה שבה נמצא הקובץ המקורי, אלא אם למשתמש ששולח את הבקשה אין הרשאת כתיבה לתיקייה הזו. במקרה כזה, העותק ייווצר בתיקיית הבסיס של המשתמש. הפונקציה מחזירה את אובייקט הקובץ שנוצר בהצלחה.

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

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

סכימת הקלט

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

CopyFileRequest

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

  "title": string

  "parentId": string
}
שדות
fileId

string

חובה. המזהה של הקובץ שרוצים להעתיק.

שדה איחוד _title.

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

string

הכותרת של הקובץ החדש שנוצר. אם הוא ריק, השם יהיה 'עותק של [שם הקובץ המקורי]'.

שדה איחוד _parent_id.

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

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, כולל.

הערות על כלי

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