MCP Tools Reference: drivemcp.googleapis.com

الأداة: read_file_content

يمكنك استدعاء هذه الأداة لجلب تمثيل بلغة طبيعية لملف Drive، ويمكنك أيضًا جلب التعليقات.

قد يكون محتوى الملف غير مكتمل بالنسبة إلى الملفات الكبيرة جدًا. سيتغير التمثيل النصي بمرور الوقت، لذا لا تفترض تنسيقًا معيّنًا للنص الذي تعرضه هذه الأداة. إذا كانت هذه الميزة متاحة، سيتم تضمين الإشارات في التعليقات ضمن المحتوى.

أنواع MIME المتوافقة:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.presentation
  • application/vnd.google-apps.spreadsheet
  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.oasis.opendocument.spreadsheet
  • application/vnd.oasis.opendocument.presentation
  • application/x-vnd.oasis.opendocument.text
  • image/png
  • image/jpeg
  • image/jpg

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

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

مخطط الإدخال

طلب قراءة محتوى الملف مع إمكانية استرداد التعليقات

ReadFileContentRequest

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

string

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

boolean

تحديد ما إذا كان سيتم تضمين التعليقات في الردّ سيتم تضمين التعليقات في المحتوى النصي للملف مع ربطها بسلاسل التعليقات.

مخطط النتائج

ردّ لقراءة محتوى الملف

ReadFileContentResponse

تمثيل JSON 
{
  "contentAnchoredComments": [
    {
      object (CommentThread)
    }
  ],
  "unanchoredComments": [
    {
      object (CommentThread)
    }
  ],

  "fileContent": string

  "textFormattingNotSupported": boolean
  // End of list of possible types for union field
  // _text_formatting_not_supported.

  "commentsNotSupported": boolean
}
الحقول
contentAnchoredComments[]

object (CommentThread)

سلاسل التعليقات المُشار إليها في file_content الذي تم عرضه
unanchoredComments[]

object (CommentThread)

سلاسل التعليقات التي تعذّر ربطها بمحتوى محدّد في الملف الذي تم إرجاعه

حقل الربط _file_content

يمكن أن يكون التعليق _file_content إحدى القيم التالية فقط:
fileContent

string

محتوى ملف Drive الذي يتم عرضه بتنسيق نصي قد يكون هذا الحقل فارغًا إذا كان الملف غير متوافق مع تنسيق النصوص. يمكن أن تتضمّن مراجع التعليقات إذا كانت قيمة include_comments هي "صحيح" في الطلب.

حقل الربط _text_formatting_not_supported

يمكن أن يكون التعليق _text_formatting_not_supported إحدى القيم التالية فقط:
textFormattingNotSupported

boolean

تُستخدَم لتحديد ما إذا كان يمكن تنسيق النص في هذا الملف. في حال اختيار القيمة "true"، سيكون file_content فارغًا.

حقل الربط _comments_not_supported

يمكن أن يكون التعليق _comments_not_supported إحدى القيم التالية فقط:
commentsNotSupported

boolean

تُستخدَم لتحديد ما إذا كان من الممكن استرداد التعليقات لهذا الملف. يتم عرض هذا الحقل فقط إذا كانت قيمة include_comments هي "صحيح" في الطلب ولم تكن التعليقات غير متاحة.

CommentThread

تمثيل JSON 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
الحقول
replies[]

object (Post)

تمثّل هذه السمة الردود على المشاركة الأولى في سلسلة التعليقات.

حقل الربط _comment_id

يمكن أن يكون التعليق _comment_id إحدى القيم التالية فقط:
commentId

string

رقم تعريف سلسلة التعليقات. هذا هو المعرّف نفسه المستخدَم في التعليق الأولي.

حقل الربط _status

يمكن أن يكون التعليق _status إحدى القيم التالية فقط:
status

enum (Status)

تمثّل هذه السمة حالة سلسلة التعليقات.

حقل الربط _head_post

يمكن أن يكون التعليق _head_post إحدى القيم التالية فقط:
headPost

object (Post)

تمثّل هذه السمة المشاركة الأولى في سلسلة التعليقات.

نشر

تمثيل JSON 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
الحقول

حقل الربط _post_id

يمكن أن يكون التعليق _post_id إحدى القيم التالية فقط:
postId

string

معرّف المشاركة.

حقل الربط _content

يمكن أن يكون التعليق _content إحدى القيم التالية فقط:
content

string

تمثّل هذه السمة محتوى المشاركة.

حقل الربط _author_name

يمكن أن يكون التعليق _author_name إحدى القيم التالية فقط:
authorName

string

تمثّل هذه السمة اسم مؤلف المشاركة.

حقل الربط _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".

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

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

الحالة

تحدّد هذه السمة حالة سلسلة التعليقات.

عمليات التعداد
STATUS_UNSPECIFIED
OPEN
RESOLVED

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

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
  • 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