عمليات ملفات Drive المجمعة عبر API/MCP

تتيح العمليات المجمعة للتكامل تنفيذ إجراء على العديد من ملفات ومجلدات Drive في طلب واحد. وهي مفيدة لأرشفة المجلدات القديمة أو التراجع عن عملية تنظيف خاطئة أو نقل التقارير التي تم إنشاؤها أو مسح محتويات المهملات التي تمت مراجعتها.

نظرا إلى أن الإجراءات المجمعة يمكن أن تمس الكثير من البيانات، صممها باستخدام نطاقات حذرة ومعاينات ومراجعة للتدقيق.

ما يمكن أن تفعله العمليات المجمعة

يدعم Drive الإجراءات المجمعة التالية:

• إرسال الملفات والمجلدات إلى المهملات.
• استعادة الملفات والمجلدات من المهملات.
• نقل الملفات والمجلدات إلى مجلد مستهدف.
• حذف الملفات والمجلدات الموجودة في المهملات نهائيا.

يمكن أن تتضمن الطلبات المجمعة ما يصل إلى 5,000 معرّف محدد. لعمليات التنظيف الأكبر، شغّل عدة دفعات خضعت للمراجعة بدلا من مهمة واحدة غير محدودة.

تحديد المعرّفات

استخدم أدوات التصفح أو شجرة المجلدات أو البحث أو تحديد الكل لإنشاء قائمة بالمعرّفات. يتضمن MCP الأداة drive_select_all_ids لمسارات العمل التي تحتاج إلى "كل شيء في هذا المجلد" من دون إجبار الوكيل على التنقل بين الصفحات يدويا.

قبل تنفيذ دفعة تدميرية، اطلب من الوكيل تلخيص الإجراء المخطط له:

• مساحة Drive المستهدفة.
• عدد الملفات والمجلدات.
• مجلد الوجهة، في حالة النقل.
• ما إذا كانت العملية قابلة للاستعادة.
• النطاق المطلوب وبوابة أمان MCP.

REST endpoints

POST /api/v1/drive/spaces/{space}/bulk:trash
POST /api/v1/drive/spaces/{space}/bulk:restore
POST /api/v1/drive/spaces/{space}/bulk:move
POST /api/v1/drive/spaces/{space}/bulk:purge

استخدم ترويسة Idempotency-Key لكل طلب مجمع. إذا حدثت إعادة محاولة، يمكن أن يعيد TrekMail النتيجة الأصلية بدلا من تكرار الدفعة.

أدوات MCP

drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge

الإجراء drive_bulk_purge دائم ويتطلب نطاق الحذف النهائي المطابق. وفي خادم MCP مستضاف محليا، يمكن للمسؤول أيضا اشتراط TREKMAIL_ALLOW_DESTRUCTIVE=true قبل إتاحة الأداة.

نمط التنظيف الآمن

استخدم عملية تنظيف من خطوتين في معظم عمليات الأتمتة:

1. انقل الملفات القديمة إلى مجلد Archive أو إلى المهملات.
2. انتظر المراجعة البشرية أو مهمة صيانة مجدولة منفصلة قبل الحذف النهائي.

يبقي ذلك الوكيل اليومي مفيدا مع الحفاظ على خيارات الاستعادة.

تصميم الأذونات

احتفظ بالحذف النهائي في رمز مميز منفصل. إذا كان مسار العمل لا يفعل سوى أرشفة الملفات، فهو لا يحتاج إلى الحذف النهائي على الإطلاق.