MCP Tools Reference: drivemcp.googleapis.com

الأداة: create_file

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

في حال تحميل محتوى، يُفضّل استخدام "text_content" للمحتوى النصي. بالنسبة إلى المحتوى غير المتوافق مع ترميز UTF8، استخدِم الحقل "base64_content" ورمِّز البيانات باستخدام base64 لضبطها في هذا الحقل.

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

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

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

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

عند تحميل المحتوى، يجب ملء الحقل content_mime_type ويجب أن يتطابق مع نوع المحتوى الذي يتم تحميله.

سيتم تلقائيًا تحويل المحتوى المتوافق إلى أنواع MIME الخاصة بالطرف الأول من Google.

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

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة create_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": "create_file",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

طلب تحميل ملف

CreateFileRequest

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

string

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

string

متوقف نهائيًا لا تستخدم هذا الرمز!! استخدِم content_mime_type بدلاً من ذلك.
contentMimeType

string

نوع MIME للمحتوى الذي يتم تحميله هذه السمة مطلوبة عند تقديم أي نوع من المحتوى.
content

string

محتوى الملف بترميز base64 يجب أن يكون حقل المحتوى مشفَّرًا دائمًا بترميز base64 بغض النظر عن نوع MIME للملف. متوقف نهائيًا استخدِم base64_content أو text_content بدلاً من ذلك.
base64Content

string

اختياريّ. المحتوى المشفّر بترميز base64 الذي سيتم تحميله من الخطأ ضبط هذا الحقل وحقل text_content.
textContent

string

اختياريّ. يشير هذا الحقل إلى المحتوى النصي (UTF-8) الذي سيتم تحميله. من الخطأ ضبط هذا الحقل وحقل base64_content.
parentId

string

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

boolean

اضبط القيمة على "صحيح" للاحتفاظ بنوع MIME للمحتوى الذي تم تمريره وعدم تحويله إلى نوع Google. على سبيل المثال، بدون ذلك، سيتم تحويل نوع MIME الخاص بالمحتوى النصي/العادي إلى application/vnd.google-apps.document. ليس له أي تأثير على الأنواع التي ليس لها مكافئ في 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

  "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) المنقضية منذ بداية حقبة يونكس 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: ✅

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file