注意: 需要授权。
创建文件的副本,并使用补丁程序语义应用所有请求的更新。 立即尝试。
请求
HTTP请求
POST https://www.googleapis.com/drive/v3/files/ fileId / copy
参量
参数名称 | 值 | 描述 |
---|---|---|
路径参数 | ||
fileId | string | 文件的ID。 |
可选查询参数 | ||
fields | string | 您想要包含在响应中的字段的路径。如果未指定,则响应包括此方法专用的默认字段集。对于开发,您可以使用特殊值* 返回所有字段,但是仅选择所需的字段即可获得更高的性能。有关更多信息,请参见部分响应文档。 |
ignoreDefaultVisibility | boolean | 是否忽略所创建文件的域的默认可见性设置。域管理员可以选择默认使所有上载的文件对域可见;此参数绕过该请求的行为。权限仍然从父文件夹继承。(默认值:false ) |
keepRevisionForever | boolean | 是否在新的主修订中设置“ keepForever”字段。这仅适用于Google云端硬盘中具有二进制内容的文件。该文件只能保留200个修订版本。如果达到限制,请尝试删除固定的修订。(默认值:false ) |
ocrLanguage | string | 图像导入期间用于OCR处理的语言提示(ISO 639-1代码)。 |
supportsAllDrives | boolean | 警告:不推荐使用此项目。 不推荐使用-请求的应用程序是否同时支持“我的驱动器”和共享驱动器。此参数仅在2020年6月1日之前有效。之后,假定所有应用程序都支持共享驱动器。(默认值:false ) |
supportsTeamDrives | boolean | 警告:不推荐使用此项目。 不推荐使用,而是使用supportsAllDrives。(默认值:false ) |
授权书
此请求需要具有以下至少一个范围的授权:
范围 |
---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
https://www.googleapis.com/auth/drive.appdata |
https://www.googleapis.com/auth/drive.photos.readonly |
某些范围受到限制,需要对您的应用进行安全评估才能使用它们。有关更多信息,请参见身份验证和授权页面。
要求正文
在请求正文中,提供具有以下属性的“ 文件”资源:
物业名称 | 值 | 描述 | 笔记 |
---|---|---|---|
可选属性 | |||
appProperties | object | 任意键/值对的集合,它们对请求的应用是私有的。 在更新和复制请求中将清除具有空值的条目。 | 可写的 |
contentHints.thumbnail.image | bytes | 用URL安全的Base64编码的缩略图数据(RFC 4648第5部分)。 | 可写的 |
contentHints.thumbnail.mimeType | string | 缩略图的MIME类型。 | 可写的 |
copyRequiresWriterPermission | boolean | 对于读者和评论者,应禁用复制,打印或下载此文件的选项。 | 可写的 |
description | string | 文件的简短描述。 | 可写的 |
id | string | 文件的ID。 | 可写的 |
mimeType | string | 文件的MIME类型。 如果未提供任何值,则Google云端硬盘会尝试从上传的内容中自动检测适当的值。除非上载新修订版,否则无法更改该值。 如果使用Google Doc MIME类型创建文件,则将尽可能导入上载的内容。受支持的导入格式在“关于”资源中发布。
| 可写的 |
modifiedTime | datetime | 任何人上次修改文件的时间(RFC 3339日期时间)。 请注意,设置ModifyedTime也将为用户更新ModifyByMeTime。 | 可写的 |
name | string | 文件名。这在文件夹中不一定是唯一的。请注意,对于不可变项,例如共享驱动器的顶层文件夹,“我的驱动器”根文件夹和“应用程序数据”文件夹,名称是恒定的。 | 可写的 |
parents[] | list | 包含文件的父文件夹的ID。 如果未在创建请求中指定,则文件将直接放置在用户的“我的云端硬盘”文件夹中。如果未将其指定为复制请求的一部分,则文件将继承源文件的所有可发现父级。更新请求必须使用 | 可写的 |
properties | object | 对所有应用程序可见的任意键值对的集合。 在更新和复制请求中将清除具有空值的条目。 | 可写的 |
starred | boolean | 用户是否已为文件加星标。 | 可写的 |
viewedByMeTime | datetime | 用户上次查看文件的时间(RFC 3339日期时间)。 | 可写的 |
writersCanShare | boolean | 具有唯一writer 权限的用户是否可以修改文件的权限。未填充共享驱动器中的项目。 | 可写的 |
响应
如果成功,此方法将在响应正文中返回一个文件资源。
试试吧!
使用下面的API资源管理器对实时数据调用此方法,然后查看响应。
function copyDocs () {
gapi.client.drive
.files.copy({'fileId': '17INW_fB0ISzk2imfjrjHtIe2zNDUyG9znKsaZpSh1AE'})
.then(function(response) {
appendPre('Files:');
var files = response.result.files
if (files && files.length > 0) {
for (var i = 0; i < files.length; i++) {
var file = files[i];
appendPre(file.name + ' (' + file.id + ')');
}
} else {
appendPre('No files found.')
}
})
}