MCP Tools Reference: drivemcp.googleapis.com

الأداة: copy_file

يمكنك استدعاء هذه الأداة لنسخ ملف حالي في Google Drive. تسمح الأداة بتحديد عنوان جديد ومجلد رئيسي للنسخة. إذا لم يتم تحديد العنوان، سيكون عنوان النسخة "نسخة من {العنوان الأصلي}". وإذا لم يتم تحديد المجلد الرئيسي، سيتم إنشاء النسخة في المجلد نفسه الذي يحتوي على الملف الأصلي، ما لم يكن لدى المستخدم الذي يطلب النسخ إذن الكتابة في هذا المجلد، وفي هذه الحالة سيتم إنشاء النسخة في مجلد المستخدم الرئيسي. تعرض الأداة كائن الملف الذي تم إنشاؤه حديثًا بعد اكتمال عملية النسخ بنجاح.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة copy_file في MCP.

طلب 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

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

ما إذا كان بإمكان مقدِّم الطلب إضافة ملفات فرعية إلى هذا المجلد تكون هذه القيمة دائمًا "خطأ" لأنواع الملفات غير المجلدات.

الطابع الزمني

تمثيل JSON 
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

تشير هذه السمة إلى عدد ثواني التوقيت العالمي المنسق (UTC) المنقضية منذ بداية حقبة يونكس 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