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

以下代码示例展示了如何使用 fileId 将文件标记为已移至回收站：

body_value = {'trashed': True}

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

const body_value = {
  'trashed': true
};

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

将 FILE_ID 替换为您要移至回收站的文件的 fileId。

确定已移至回收站的文件的属性

文件移至回收站后，您可以检索其他文件属性。您可以使用 get方法对files资源调用fileId路径参数，并在fields参数中使用以下已移至回收站的字段之一。如需详细了解 fields 参数，请参阅使用 fields 参数。

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

• trashed：文件是否已移至回收站（无论是明确移至回收站，还是从已移至回收站的父文件夹中移至回收站）。请注意，虽然将 trashed 与 update 方法搭配使用会设置文件的状态，但 get 方法会检索文件的状态。
• explicitlyTrashed：文件是否已明确移至回收站（而不是从父文件夹中以递归方式移至回收站）。

系统仅会为共享云端硬盘中的文件填充以下字段：

• trashedTime：项移至回收站的时间，采用 RFC 3339 日期时间格式。如果您使用的是旧版 Drive API v2，则此字段称为 trashedDate。
• trashingUser：如果文件是明确移至回收站的，则为将其移至回收站的用户。

从回收站中还原文件

如需从回收站中还原文件，请使用 update方法对files资源调用，并使用fileId路径参数将 布尔值trashed字段设置为 false。如需取消将共享云端硬盘文件移至回收站，您还必须将布尔值 supportsAllDrives查询 参数设置为true。如需了解详情，请参阅实现共享云端硬盘 支持。

如果成功，响应 正文将包含一个 files资源实例。

以下代码示例展示了如何使用 fileId 将文件标记为已取消移至回收站：

body_value = {'trashed': False}

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

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。

如果成功，响应 正文将包含一个空的 JSON 对象。

以下代码示例展示了如何使用 fileId 永久删除回收站中的所有文件：

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

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

删除

您可以永久删除云端硬盘文件，而无需将其移至回收站。删除某文件后，该文件的任何共享对象都会失去访问权限。如果您希望其他人保留对文件的访问权限，可以在删除之前将所有权转让给其他人。

如需删除共享云端硬盘文件，用户必须对父文件夹拥有 role=organizer 权限。如果您要删除文件夹，则用户拥有的所有后代也会被删除。如需了解详情，请参阅权限。

如需永久删除用户拥有的文件，而无需将其移至回收站，请对 files 资源使用 delete 方法。如需删除共享云端硬盘文件，您还必须 将布尔值 supportsAllDrives 查询 参数设置为 true。如需了解详情，请参阅实现共享云端硬盘 支持。

如果成功，响应 正文将包含一个空的 JSON 对象。

以下代码示例展示了如何使用 fileId 删除文件：

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

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

将 FILE_ID 替换为您要 删除的文件的 fileId。

权限

下表显示了将文件和文件夹移至回收站或删除所需的角色权限。如需查看角色及其允许的操作的完整列表， 请参阅角色和权限。

功能

A files 资源包含一系列布尔值 capabilities 字段，这些字段指示用户对此文件拥有的功能。

如需检查功能，请使用 fileId 路径参数对 files 资源调用 get 方法 ，并在 fields 参数中使用以下 capabilities 字段之一。如需详细了解 fields 参数，请参阅使用 fields 参数。

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

• capabilities.canTrash：当前用户是否可以将此文件移至回收站。
• capabilities.canUntrash：当前用户是否可以从回收站中还原此文件。
• capabilities.canDelete：当前用户是否可以删除此文件。
• capabilities.canRemoveChildren：当前用户是否可以从此文件夹中移除子项。如果项不是文件夹，则为 false。

系统仅会为共享云端硬盘中的文件填充以下字段：

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

文件和文件夹限制

云端硬盘文件和文件夹以及共享云端硬盘文件夹都有一些存储空间限制。

一般来说，达到项数限制后，创建更多空间的唯一方法是 通过永久删除项或使用 其他帐号。将文件移至回收站不足以释放空间。

如需详细了解文件和文件夹限制，请参阅以下内容：

• 文件中的文件和文件夹限制
• 共享云端硬盘中的文件夹限制

相关主题

• 删除 Google 云端硬盘中的文件
• 共享云端硬盘与“我的云端硬盘”API 的区别
• 角色和权限