将文件和文件夹移到回收站或将其删除

您可以从“我的云端硬盘”和共享云端硬盘中移除 Google 云端硬盘文件和文件夹。为此，您有两种选择：删除或删除。

您可以将文件和文件夹移至回收站，然后还原（移至回收站后的 30 天内）。删除文件和文件夹会将其从云端硬盘中永久移除。如果您一次性将多个文件或文件夹移至回收站、恢复或永久删除，则可能需要一段时间才能看到更改生效。

本指南介绍了如何在云端硬盘中处理文件。

垃圾艺术

如要移除云端硬盘文件，您可以将其移至回收站。回收站中的文件会在 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 v2 版本，则此字段称为 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 字段，用于表示是否可以对文件执行操作。

如需检查功能，请调用 files.get 方法，并将 fileId 和 fields 参数设置为 capabilities 字段。如需详细了解如何使用 fields 参数返回字段，请参阅返回文件的特定字段。

系统会为所有文件填充以下字段：

  • capabilities.canTrash：当前用户是否可以将此文件移至回收站。
  • capabilities.canUntrash：当前用户是否可以从回收站中恢复此文件。
  • capabilities.canDelete：当前用户是否可以删除此文件。
  • capabilities.canRemoveChildren：当前用户是否可以从此文件夹中移除子级。如果内容不是文件夹，则该值为 false。

只有位于共享云端硬盘中的文件时，系统才会填充以下字段：

  • capabilities.canTrashChildren：当前用户是否可以将此文件夹的子级移至回收站。如果内容不是文件夹，则该值为 false。
  • capabilities.canDeleteChildren：当前用户是否可以删除此文件夹的子级。如果内容不是文件夹，则该值为 false。