העברה לאשפה או מחיקה של קבצים ותיקיות

אתם יכולים להסיר קבצים ותיקיות מ-Google Drive גם מ'האחסון שלי' וגם מתיקיות האחסון השיתופי. יש שתי אפשרויות: העברה לאשפה או מחיקה.

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

במדריך הזה מוסבר איך להיפטר מקבצים ב-Drive.

אשפה

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

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

כדי לאמת שאתם הבעלים של הקובץ, קוראים לשיטה files.get עם הפרמטרים fileId ו-fields שמוגדרים לשדה הבוליאני ownedByMe. השדה ownedByMe לא מאוכלס עבור קבצים בתיקיות אחסון שיתופי כי הם בבעלות תיקיית האחסון השיתופי, ולא בבעלות של משתמשים פרטיים. מידע נוסף על החזרת שדות באמצעות הפרמטר fields זמין במאמר החזרת שדות ספציפיים של קובץ.

אם אתם לא הבעלים של הקובץ אבל אתם רוצים עותק של הקובץ שהועבר לאשפה, אתם יכולים:

  • יוצרים עותק של הקובץ.
  • פונים לבעלים ומבקשים לשחזר את הקובץ מהאשפה.

העברת קובץ לאשפה

כדי להעביר קובץ לאשפה, משתמשים בשיטה files.update ומגדירים את השדה trashed לערך True. כדי להעביר קובץ באחסון השיתופי לאשפה, צריך להגדיר את פרמטר השאילתה supportsAllDrives לערך True. מידע נוסף זמין במאמר בנושא הטמעה של תמיכה באחסון שיתופי.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של משאב הקבצים.

דוגמת הקוד הבאה מראה איך להשתמש בפקודה fileId כדי לסמן את הקובץ כקובץ שהועבר לאשפה:

Python

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': true
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

מחליפים את FILE_ID בfileId של הקובץ שרוצים להעביר לאשפה.

קביעת המאפיינים של קובץ שהועבר לאשפה

כשמעבירים קובץ לאשפה, אפשר לאחזר מאפיינים נוספים של files. אפשר להשתמש בשיטה files.get ולכלול את השדות הבאים בפרמטר fields. מידע נוסף זמין במאמר החזרת שדות ספציפיים של קובץ.

השדות הבאים מאוכלסים לכל הקבצים:

  • ‫trashed: האם הקובץ הועבר לאשפה, באופן מפורש או מתיקיית אב שהועברה לאשפה. שימו לב: השימוש ב-trashed עם ה-method‏ files.update מגדיר את הסטטוס של הקובץ, וה-method‏ files.get מאחזר את הסטטוס של הקובץ.
  • ‫explicitlyTrashed: האם הקובץ הועבר לאשפה באופן מפורש, בניגוד להעברה לאשפה באופן רקורסיבי מתיקיית אב.

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

  • ‫trashedTime: השעה שבה הפריט הועבר לאשפה בפורמט התאריך והשעה RFC 3339. אם אתם משתמשים בגרסה הקודמת של Drive API v2, השדה הזה נקרא trashedDate.
  • ‫trashingUser: אם הקובץ הועבר במפורש לאשפה, המשתמש שהעביר אותו לאשפה.

שחזור קובץ מהאשפה

כדי לשחזר קובץ מהאשפה, משתמשים ב-method ‏files.update ומגדירים את השדה trashed לערך False. כדי לשחזר קובץ מאחסון שיתופי, צריך להגדיר את פרמטר השאילתה supportsAllDrives לערך True. מידע נוסף זמין במאמר בנושא הטמעה של תמיכה באחסון שיתופי.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של משאב הקבצים.

דוגמת הקוד הבאה מראה איך להשתמש בפקודה fileId כדי לסמן את הקובץ כלא מושבת:

Python

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': false
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

מחליפים את FILE_ID בfileId של הקובץ שרוצים לשחזר מהאשפה.

רוקן את האשפה

אפשר למחוק באופן סופי את כל הקבצים ב-Drive שהועברו לאשפה על ידי המשתמש באמצעות השיטה files.emptyTrash. כדי לרוקן את האשפה של אחסון שיתופי, צריך להגדיר גם את פרמטר השאילתה driveId למזהה של האחסון השיתופי.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה יכיל מופע ריק.

בדוגמת הקוד הבאה אפשר לראות איך משתמשים ב-fileId כדי למחוק את כל הקבצים באשפה:

Python

response = drive_service.files().emptyTrash().execute()

Node.js

 const response = await drive_service.files.emptyTrash({
    });
    return response;

מחיקה

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

כדי למחוק קובץ באחסון שיתופי, למשתמש צריכה להיות הרשאה role=organizer בתיקיית האב. אם מוחקים תיקייה, גם כל התיקיות והקבצים שמוכלים בה ונמצאים בבעלות המשתמש נמחקים. מידע נוסף זמין במאמר הרשאות.

כדי למחוק קובץ בבעלות משתמש באופן סופי בלי להעביר אותו לאשפה, משתמשים בשיטה files.delete. כדי למחוק קובץ באחסון שיתופי, צריך להגדיר את פרמטר השאילתה supportsAllDrives לערך True. מידע נוסף זמין במאמר בנושא הטמעה של תמיכה באחסון שיתופי.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה יכיל מופע ריק.

בדוגמת הקוד הבאה מוצג אופן השימוש בפקודה fileId למחיקת הקובץ:

Python

response = drive_service.files().delete(fileId="FILE_ID").execute()

Node.js

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

מחליפים את FILE_ID בfileId של הקובץ שרוצים למחוק.

הרשאות

בטבלה הבאה מפורטות הרשאות התפקיד שנדרשות לביצוע כל פעולה. רשימה מלאה של התפקידים והפעולות שמותרות בכל אחד מהם מופיעה במאמר תפקידים והרשאות.

פעולה מותרת owner organizer fileOrganizer writer commenter reader
העברת קבצים ותיקיות לאשפה ✔ ✔ ✔
שחזור קבצים ותיקיות מהאשפה ✔ ✔ ✔
ריקון האשפה ✔ ✔
מחיקה סופית של קובץ או תיקייה ✔ ✔
מחיקת קבצים ותיקיות באחסון שיתופי [*] ✔

יכולות

משאב files מכיל אוסף של שדות בוליאניים capabilities שמשמשים לציון האם אפשר לבצע פעולה בקובץ.

כדי לבדוק את היכולות, קוראים לשיטה files.get עם הפרמטרים fileId ו-fields שמוגדרים לשדה capabilities. מידע נוסף על החזרת שדות באמצעות הפרמטר fields זמין במאמר החזרת שדות ספציפיים של קובץ.

השדות הבאים מאוכלסים לכל הקבצים:

  • ‫capabilities.canTrash: האם המשתמש הנוכחי יכול להעביר את הקובץ הזה לאשפה.
  • ‫capabilities.canUntrash: האם המשתמש הנוכחי יכול לשחזר את הקובץ הזה מהאשפה.
  • ‫capabilities.canDelete: האם המשתמש הנוכחי יכול למחוק את הקובץ הזה.
  • ‫capabilities.canRemoveChildren: האם המשתמש הנוכחי יכול להסיר פריטים מהתיקייה הזו. הערך הוא false אם הפריט הוא לא תיקייה.

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

  • ‫capabilities.canTrashChildren: האם המשתמש הנוכחי יכול להעביר לאשפה פריטים שהם צאצאים של התיקייה הזו. הערך הוא false אם הפריט הוא לא תיקייה.
  • ‫capabilities.canDeleteChildren: האם המשתמש הנוכחי יכול למחוק פריטים בתיקייה הזו. הערך הוא false אם הפריט הוא לא תיקייה.

מגבלות על קבצים ותיקיות

יש מגבלות אחסון מסוימות על קבצים ותיקיות ב-Drive, וגם על תיקיות באחסון שיתופי.

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

מידע נוסף על מגבלות הקבצים והתיקיות זמין במאמרים הבאים: