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 في "نظام إدارة المحادثات".

طلب Curl 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--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

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

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