Method: files.copy

创建指定文件的副本。

HTTP 请求

POST https://www.googleapis.com/drive/v2/files/{fileId}/copy

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

要复制的文件的 ID。

查询参数

参数
convert

boolean

是否将此文件转换为相应的文档编辑器格式。

enforceSingleParent
(deprecated)

boolean

已弃用:不再支持将文件复制到多个文件夹。请改用快捷键。

ocr

boolean

是否尝试对 .jpg、.png、.gif 或 .pdf 上传的内容进行 OCR。

ocrLanguage

string

如果 ocr 为 true,则提示要使用的语言。有效值为 BCP 47 代码。

pinned

boolean

是否固定新副本的标题修订版本。一个文件最多可以有 200 个固定修订版本。

supportsAllDrives

boolean

发出请求的应用是否同时支持“我的云端硬盘”和共享云端硬盘。

supportsTeamDrives
(deprecated)

boolean

已废弃:请改用 supportsAllDrives

timedTextLanguage

string

计时文本的语言。

timedTextTrackName

string

计时文本轨道名称。

visibility

enum (Visibility)

新文件的公开范围。仅当来源不是原生 Google 文档且 convert=false 时,此参数才相关。

includePermissionsForView

string

指定要包含在响应中的其他视图权限。仅支持 published

includeLabels

string

以英文逗号分隔的 labelInfo 部分所含标签的 ID 列表。

请求正文

请求正文包含一个 File 实例。

响应正文

如果成功,则响应正文包含一个 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
  • https://www.googleapis.com/auth/drive.photos.readonly

某些范围受到限制,您的应用必须接受安全评估才能使用这些范围。有关详情,请参阅授权指南