MCP Tools Reference: drivemcp.googleapis.com

الأداة: create_file

استدعِ هذه الأداة لإنشاء ملف أو تحميله إلى Google Drive.

في حال تحميل ملف، يجب ترميز المحتوى بترميز Base64 في الحقل content بغض النظر عن نوع MIME للملف الذي يتم تحميله.

تعرض هذه الطريقة عنصر File واحدًا عند إنشاء الملف بنجاح.

يمكن إنشاء أنواع MIME التالية الخاصة بالطرف الأول من Google Drive بدون تقديم محتوى:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.spreadsheet
  • application/vnd.google-apps.presentation

سيتم تلقائيًا إجراء عمليات التحويل التالية لأنواع MIME التالية:

  • من text/plain إلى application/vnd.google-apps.document
  • من text/csv إلى application/vnd.google-apps.spreadsheet

لإيقاف عمليات التحويل لأنواع MIME الخاصة بالطرف الأول، اضبط disable_conversion_to_google_type على "صحيح".

يمكن إنشاء المجلدات من خلال ضبط نوع MIME على application/vnd.google-apps.folder.

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

طلب Curl 
curl --location 'https://drivemcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_file",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

طلب تحميل ملف

CreateFileRequest

تمثيل JSON 
{
  "title": string,
  "mimeType": string,
  "content": string,
  "parentId": string,
  "disableConversionToGoogleType": boolean
}
الحقول
title

string

تمثّل هذه السمة عنوان الملف.
mimeType

string

نوع MIME للملف الذي سيتم تحميله.
content

string

محتوى الملف بترميز base64 يجب أن يكون حقل المحتوى مشفَّرًا دائمًا بترميز base64 بغض النظر عن نوع MIME للملف.
parentId

string

رقم تعريف الملف الرئيسي
disableConversionToGoogleType

boolean

في حال ضبط هذا الحقل على "صحيح"، لن يتم تحويل الملف إلى نوع ملف من Google. ليس له أي تأثير في أنواع MIME التي ليس لها مكافئ في Google.

مخطط النتائج

تمثّل هذه السمة ملفًا.

ملف

تمثيل 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
}
الحقول
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

عنوان البريد الإلكتروني لمالك الملف

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

تمثيل 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، بما في ذلك طرفي النطاق.

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅