MCP Tools Reference: drivemcp.googleapis.com

الأداة: download_file_content

يمكنك استدعاء هذه الأداة لتنزيل محتوى ملف في Drive كسلسلة مشفّرة بترميز base64.

إذا كان الملف من نوع MIME الأصلي في Google Drive، يكون الحقل exportMimeType مطلوبًا وسيحدّد تنسيق الملف الذي تم تنزيله.

إذا لم يتم العثور على الملف، جرِّب استخدام أدوات أخرى، مثل search_files للعثور على الملف الذي يطلبه المستخدم.

إذا أراد المستخدم تمثيلاً بلغة طبيعية لمحتوى Drive، استخدِم أداة read_file_content (read_file_content يجب أن تكون أصغر حجمًا وأسهل في التحليل).

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

مخطط الإدخال

يحدّد طلبًا لتنزيل محتوى ملف.

DownloadFileRequest

تمثيل JSON 
{
  "fileId": string,
  "exportMimeType": string
}
الحقول
fileId

string

الحقل مطلوب. معرّف الملف المطلوب استرداده.
exportMimeType

string

اختياريّ. بالنسبة إلى ملفات Google الأصلية، يكون نوع MIME الذي يتم تصدير الملف إليه، ويتم تجاهله بخلاف ذلك. يتم ضبط القيمة تلقائيًا على نص في حال عدم تحديدها.

مخطط النتائج

الردّ على طلب تنزيل ملف

FileContent

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

string

معرّف الملف
title

string

عنوان الملف
mimeType

string

نوع MIME للملف
content

string

محتوى الملف المشفّر بترميز base64

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

تلميح مدمِّر: ❌ | تلميح متكرّر: ✅ | تلميح للقراءة فقط: ✅ | تلميح للعالم المفتوح: ❌

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly