您可以从“我的云端硬盘”和共享云端硬盘中移除 Google 云端硬盘文件和文件夹。您可以通过以下两种方式来完成此操作:放入回收站或删除。
您可以将文件和文件夹移至回收站,然后在 30 天内恢复它们。删除文件和文件夹会将其从云端硬盘中永久移除。如果您同时将多个文件或文件夹移到回收站、还原或永久删除,则可能要过一段时间才能看到更改生效。
本指南介绍了如何在云端硬盘中处置文件。
使用 fields 参数
如果您想指定要在响应中返回的字段,可以使用 files
资源的任何方法设置 fields
system 参数。如果您省略 fields
参数,服务器会返回特定于方法的默认字段集。例如,list
方法仅返回每个文件的 kind
、id
、name
、mimeType
和 resourceKey
字段。如需返回其他字段,请参阅返回特定字段。
回收站
如需移除云端硬盘文件,您可以将其移至回收站。回收站中的文件会在 30 天后被自动删除。在 30 天期限内,您可以从回收站恢复文件。
只有文件所有者才能将文件放入回收站,其他用户无法查看所有者回收站中的文件。如果您尝试将自己不拥有的文件放入回收站,则会收到 insufficientFilePermissions
错误。如需了解详情,请参阅权限。
如需验证您是否是文件所有者,请对 files
资源调用 get
方法,并将 fileId
路径参数和 fields
参数设置为布尔值 ownedByMe
字段。由于共享云端硬盘中的文件归共享云端硬盘而非个人用户所有,因此系统不会为这些文件填充 ownedByMe
字段。如需详细了解 fields
参数,请参阅使用 fields 参数。
如果您不是文件所有者,但仍想获取已放入回收站的文件的副本,请执行以下任一操作:
- 制作文件的副本。
- 联系所有者从回收站中恢复文件。
将文件移至回收站
如需将文件移至回收站,请对 files
资源使用 update
方法,并使用 fileId
路径参数,然后将布尔值 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
资源使用 get
方法,并使用 fileId
路径参数,同时在 fields
参数中使用以下某个已放入回收站的字段。如需详细了解 fields
参数,请参阅使用 fields 参数。
系统会为所有文件填充以下字段:
trashed
:相应文件是否已放入回收站,无论是明确放入还是因父文件夹已放入回收站而放入。请注意,虽然使用trashed
和update
方法可以设置文件的状态,但get
方法会检索文件的状态。explicitlyTrashed
:文件是否被明确放入回收站,而不是从父文件夹递归放入回收站。
以下字段仅会针对位于共享云端硬盘中的文件进行填充:
trashedTime
:相应项目被放入回收站的时间,采用 RFC 3339 日期时间格式。如果您使用的是之前的 Drive API v2 版本,则此字段称为trashedDate
。trashingUser
:如果文件被明确放入回收站,则为将其放入回收站的用户。
还原回收站中的文件
如需从回收站恢复文件,请对 files
资源使用 update
方法,并使用 fileId
路径参数将布尔值 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。
如果成功,则响应正文包含一个空的 JSON 对象。
以下代码示例展示了如何使用 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
。如需了解详情,请参阅实现共享云端硬盘支持。
如果成功,则响应正文包含一个空的 JSON 对象。
以下代码示例展示了如何使用 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
路径参数对 files
资源调用 get
方法,并在 fields
参数中使用以下 capabilities
字段之一。如需详细了解 fields
参数,请参阅使用 fields 参数。
系统会为所有文件填充以下字段:
capabilities.canTrash
:当前用户是否可以将相应文件移至回收站。capabilities.canUntrash
:当前用户是否可以从回收站中恢复相应文件。capabilities.canDelete
:当前用户是否可以删除相应文件。capabilities.canRemoveChildren
:当前用户是否可以从相应文件夹中移除子项。如果相应内容不是文件夹,则为false
。
以下字段仅会针对位于共享云端硬盘中的文件进行填充:
capabilities.canTrashChildren
:当前用户是否可以将相应文件夹的子项放入回收站。如果相应内容不是文件夹,则为false
。capabilities.canDeleteChildren
:当前用户是否可以删除相应文件夹的子项。如果相应内容不是文件夹,则为false
。
文件和文件夹限制
云端硬盘文件和文件夹以及共享云端硬盘文件夹都有一些存储空间限制。
一般来说,达到内容数量上限后,唯一能腾出更多空间的方法是永久删除内容或使用其他账号。将文件移至回收站不足以释放空间。
如需详细了解文件和文件夹限制,请参阅以下内容: