將檔案和資料夾移至垃圾桶或刪除

您可以同時從「我的雲端硬碟」和共用雲端硬碟中移除 Google 雲端硬碟檔案和資料夾。您可以採用兩種做法：將檔案移至垃圾桶或刪除。

您可以將檔案和資料夾移至垃圾桶，然後在 30 天內還原。刪除檔案和資料夾後，這些項目就會永久從 Google 雲端硬碟中移除。如果您將多個檔案或資料夾一次移至垃圾桶、還原或永久刪除，可能需要一段時間才能看到相關變更。

本指南說明如何處理雲端硬碟中的檔案。

垃圾桶

如要移除雲端硬碟檔案，請將檔案移至垃圾桶。移至垃圾桶的檔案會在 30 天後自動刪除，只要檔案移至垃圾桶的時間未滿 30 天，您就可以還原檔案。

只有檔案擁有者可以將檔案移至垃圾桶，其他使用者無法查看擁有者垃圾桶中的檔案。如果您嘗試將不屬於自己的檔案移至垃圾桶，系統會傳回 insufficientFilePermissions 錯誤。詳情請參閱「權限」。

如要驗證您是否為檔案擁有者，請呼叫 files.get 方法，並將 fileId 和 fields 參數設為布林值 ownedByMe 欄位。共用雲端硬碟中的檔案是由共用雲端硬碟擁有，而非個別使用者，因此不會填入 ownedByMe 欄位。如要進一步瞭解如何使用 fields 參數傳回欄位，請參閱「傳回檔案的特定欄位」。

如果你不是檔案擁有者，但仍想取得已刪除檔案的副本，請執行下列任一操作：

  • 建立檔案副本。
  • 與擁有者聯絡，請擁有者從垃圾桶還原檔案。

將檔案移至垃圾桶

如要將檔案移至垃圾桶，請使用 files.update 方法，並將 trashed 欄位設為 True。如要將共用雲端硬碟檔案移至垃圾桶，您也必須將 supportsAllDrives 查詢參數設為 True。詳情請參閱「實作共用雲端硬碟支援功能」。

如果成功，回應主體會包含 files 資源的例項。

以下程式碼範例說明如何使用 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 搭配 files.update 方法時，系統會設定檔案狀態，而 files.get 方法則會擷取檔案狀態。
  • explicitlyTrashed：檔案是否已從父項資料夾中明確刪除，而非遞迴刪除。

系統只會針對共用雲端硬碟中的檔案填入下列欄位：

  • trashedTime：項目遭到刪除的時間，採用 RFC 3339 日期時間格式。如果您使用的是 Drive API 2 先前版本，這個欄位稱為 trashedDate。
  • trashingUser：如果檔案是明確丟入垃圾桶，則為丟入垃圾桶的使用者。

從垃圾桶中復原檔案

如要從垃圾桶中還原檔案，請使用 files.update 方法，並將 trashed 欄位設為 False。如要取消將共用雲端硬碟檔案移至垃圾桶，您也必須將 supportsAllDrives 查詢參數設為 True。詳情請參閱「導入共用雲端硬碟支援功能」。

如果成功，回應主體會包含 files 資源的例項。

以下程式碼範例說明如何使用 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。

清空垃圾桶

您可以使用 files.emptyTrash 方法，永久刪除使用者移至垃圾桶的所有雲端硬碟檔案。如要清空共用雲端硬碟的垃圾桶，您必須將 driveId 查詢參數設為共用雲端硬碟 ID。

如果成功，回應主體會包含空白例項。

以下程式碼範例說明如何使用 fileId 刪除垃圾桶中的所有檔案：

Python

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

Node.js

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

刪除

你可以永久刪除雲端硬碟檔案，而無須將檔案移至垃圾桶。刪除檔案後，與你共用該檔案的其他人也將無法存取檔案。如要讓其他人繼續存取檔案，你可以在刪除檔案前轉移擁有權。

如要刪除共用雲端硬碟檔案，使用者必須在父資料夾上擁有 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 欄位的集合，用於指出是否可以在檔案上執行動作。

如要檢查此功能，請使用 fileId 以及 fields 參數設為 capabilities 欄位的 fields 參數呼叫 files.get 方法。如要進一步瞭解如何使用 fields 參數傳回欄位，請參閱「傳回檔案的特定欄位」。

系統會為所有檔案填入下列欄位：

  • capabilities.canTrash：目前使用者是否可以將此檔案移至垃圾桶。
  • capabilities.canUntrash：目前使用者是否可以從垃圾桶還原這個檔案。
  • capabilities.canDelete：目前的使用者能否刪除這個檔案。
  • capabilities.canRemoveChildren：目前使用者是否可以從這個資料夾中移除子項。如果項目不是資料夾，則為 false。

下列欄位只會填入位於共用雲端硬碟中的檔案：

  • capabilities.canTrashChildren：目前使用者是否可以將這個資料夾的子資料夾移至垃圾桶。如果項目不是資料夾，則為 false。
  • capabilities.canDeleteChildren：目前使用者是否可以刪除這個資料夾的子項。如果該項目不是資料夾，則此為 false。

檔案和資料夾限制

Drive 檔案和資料夾，以及共用雲端硬碟資料夾，都有一定的儲存空間限制。

一般來說，達到項目上限後，要想釋出更多空間，唯一的方法就是永久刪除項目或使用其他帳戶。將檔案移至垃圾桶並不足以釋出空間。

如要進一步瞭解檔案和資料夾限制，請參閱以下說明：