MCP Tools Reference: drivemcp.googleapis.com

الأداة: list_recent_files

يمكنك استدعاء هذه الأداة للعثور على الملفات الأخيرة لمستخدم محدّد بترتيب معيّن. ترتيب الفرز التلقائي هو recency.

ترتيبات الفرز المتاحة هي:

  • recency: أحدث طابع زمني من حقول التاريخ والوقت في الملف
  • lastModified: آخر مرة عدّل فيها أي مستخدم الملف
  • lastModifiedByMe: آخر مرة عدّل فيها المستخدم الملف

حجم الصفحة التلقائي هو 10. يمكنك استخدام next_page_token لتقسيم النتائج على صفحات.

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

مخطط الإدخال

طلب عرض قائمة بالملفات

ListFilesRequest

تمثيل JSON 
{

  "orderBy": string

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
الحقول

حقل الربط _order_by

يمكن أن يكون _order_by إحدى القيم التالية فقط:
orderBy

string

ترتيب فرز الملفات

حقل الربط _page_token

يمكن أن يكون _page_token إحدى القيم التالية فقط:
pageToken

string

رمز الصفحة الذي سيتم استخدامه للتقسيم على صفحات

حقل الربط _page_size

يمكن أن يكون _page_size إحدى القيم التالية فقط:
pageSize

integer

الحد الأقصى لعدد الملفات التي سيتم عرضها

حقل الربط _exclude_content_snippets

يمكن أن يكون _exclude_content_snippets إحدى القيم التالية فقط:
excludeContentSnippets

boolean

إذا كانت القيمة true، سيتم استبعاد مقتطف المحتوى من الردّ.

مخطط النتائج

الردّ على طلب عرض قائمة بالملفات

ListFilesResponse

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

  "nextPageToken": string
}
الحقول
files[]

object (File)

قائمة الملفات

حقل الربط _next_page_token

يمكن أن يكون _next_page_token إحدى القيم التالية فقط:
nextPageToken

string

رمز الصفحة التالية

ملف

تمثيل 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

ما إذا كان بإمكان مقدِّم الطلب إضافة ملفات فرعية إلى هذا المجلد تكون هذه القيمة دائمًا "خطأ" لأنواع الملفات غير المجلدات.

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

تمثيل 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 ضِمنًا.

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

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

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

يجب توفير أحد نطاقات 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