Method: files.copy

创建指定文件的副本。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

要复制的文件的 ID。

查询参数

参数
convert

boolean

是否将此文件转换为相应的 Google 文档编辑器格式。
enforceSingleParent
(deprecated)

boolean

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

boolean

是否尝试对 .jpg、.png、.gif 或 .pdf 上传文件执行 OCR。
ocrLanguage

string

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

boolean

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

boolean

请求的应用是否同时支持“我的云端硬盘”和共享云端硬盘。
supportsTeamDrives
(deprecated)

boolean

已弃用：请改用 supportsAllDrives。
timedTextLanguage

string

定时文字的语言。
timedTextTrackName

string

定时文本轨道名称。
visibility

enum (Visibility)

新文件的公开范围。权限仍继承自父文件夹。仅当来源不是 Google 文档文件且 convert=false 时，此参数才相关。
includePermissionsForView

string

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

string

以英文逗号分隔的标签 ID 列表，用于包含在响应的 labelInfo 部分中。

请求正文

请求正文包含一个 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

某些范围受到限制，您的应用需要通过安全评估才能使用这些范围。如需了解详情，请参阅授权指南。