ابزار: copy_file
برای کپی کردن فایل موجود در Google Drive، این ابزار را فراخوانی کنید. این ابزار امکان مشخص کردن عنوان جدید و پوشه مادر را برای نسخه کپی فراهم میکند. If the title is not specified, the copy title will be 'Copy of {original title}'If the parent folder is not specified, the copy will be created in the same folder as the original file, unless the requesting user does not have write access to that folder, in which case the copy will be created in the user's root folder.Returns the newly created File object upon successful copying.
نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار MCP copy_file را نشان میدهد.
| درخواست 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": "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 |
الزامی. شناسه فایلی که باید کپی شود. |
فیلد اتحادیه
|
|
title |
عنوان فایل تازه ایجادشده. اگر خالی باشد، عنوان «کپی از [عنوان فایل اصلی]» خواهد بود. |
فیلد اتحادیه
|
|
parentId |
شناسه ولی فایل تازه ایجادشده. اگر خالی باشد، فایل با همان والد فایل اصلی ایجاد خواهد شد. |
طرح برونداد
منبع فایل.
فایل
| نمایش 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.file