Method: files.trash
将文件移到回收站。目前经过身份验证的用户必须是相应文件的所有者,或者必须至少是共享云端硬盘文件的父级fileOrganizer
。
HTTP 请求
POST https://www.googleapis.com/drive/v2/files/{fileId}/trash
网址采用 gRPC 转码语法。
路径参数
参数 |
fileId |
string
要移至回收站的文件的 ID。
|
查询参数
参数 |
supportsAllDrives |
boolean
发出请求的应用是否同时支持“我的云端硬盘”和共享云端硬盘。
|
supportsTeamDrives (deprecated) |
boolean
已废弃:请改用 supportsAllDrives 。
|
includePermissionsForView |
string
指定要包含在响应中的其他视图权限。仅支持 published 。
|
includeLabels |
string
以英文逗号分隔的 labelInfo 部分所含标签的 ID 列表。
|
响应正文
如果成功,则响应正文包含一个 File
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
某些范围受到限制,您的应用必须接受安全评估才能使用这些范围。有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-03。
[null,null,["最后更新时间 (UTC):2024-09-03。"],[[["Permanently moves a file to the trash, requiring the user to own the file or have sufficient permissions."],["Uses an HTTP POST request with the file ID as a path parameter to specify the target file."],["Allows optional query parameters to control behavior regarding shared drives, permissions, and labels."],["Requires authorization with specific OAuth scopes, including `https://www.googleapis.com/auth/drive` or similar, for access."],["Returns a File resource describing the trashed file upon successful completion."]]],["This content describes how to move a file to the trash using the Google Drive API. The process involves sending a `POST` request to `https://www.googleapis.com/drive/v2/files/{fileId}/trash`, where `fileId` is the file's ID. The request body must be empty, and optional query parameters like `supportsAllDrives` or `includeLabels` can be added. Successful requests return a `File` instance in the response. Authorization requires specific OAuth scopes, such as `https://www.googleapis.com/auth/drive`. The user must own the file.\n"]]