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

是否固定新副本的最新修订版本。文件最多可以有 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

某些镜重受限，您的应用需要接受安全评估才能使用它们。如需了解详情，请参阅授权指南。