פעולות מרובות בקובצי 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. המתינו לבדיקה אנושית או למשימת תחזוקה מתוזמנת נפרדת לפני המחיקה לצמיתות.

כך הסוכן היומי נשאר שימושי תוך שמירה על אפשרויות השחזור.

תכנון הרשאות

שמרו את הרשאת המחיקה לצמיתות באסימון נפרד. אם תהליך עבודה רק מאחסן קבצים בארכיון, הוא אינו זקוק למחיקה לצמיתות כלל.