Method: files.create

创建文件。如需了解详情,请参阅创建和管理文件

此方法支持 /upload URI,并接受所上传的具备以下特征的媒体:

如需详细了解如何上传文件,请参阅上传文件数据

使用 create 方法创建快捷方式的应用必须指定 MIME 类型 application/vnd.google-apps.shortcut

应用在通过 API 插入文件时,应在 name 属性中指定文件扩展名。例如,插入 JPEG 文件的操作应在元数据中指定类似 "name": "cat.jpg" 的内容。

后续的 GET 请求包含只读 fileExtension 属性,该属性填充了 name 属性中最初指定的扩展名。当 Google 云端硬盘用户请求下载文件时,或者当文件通过同步客户端下载时,云端硬盘会根据文件名构建完整的文件名(带扩展名)。如果缺少扩展名,Google 云端硬盘会尝试根据文件的 MIME 类型确定扩展名。

HTTP 请求

  • 上传 URI,用于媒体上传请求:
    POST https://www.googleapis.com/upload/drive/v3/files
  • 元数据 URI,用于仅涉及元数据的请求:
    POST https://www.googleapis.com/drive/v3/files

网址采用 gRPC 转码语法。

查询参数

参数
enforceSingleParent
(deprecated)

boolean

已弃用:不再支持在多个文件夹中创建文件。

ignoreDefaultVisibility

boolean

是否忽略所创建文件的网域默认公开范围设置。网域管理员可以选择默认情况下让所有上传的文件对网域可见;此参数会绕过该行为。权限仍继承自父文件夹。

keepRevisionForever

boolean

是否在新 Head 修订版本中设置 keepForever 字段。此架构仅适用于 Google 云端硬盘中的二进制内容文件。您最多只能永久保留 200 个文件修订版本。如果达到此限制,请尝试删除已固定的修订版本。

ocrLanguage

string

在图片导入期间进行 OCR 处理的语言提示(ISO 639-1 代码)。

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

已弃用:请改用 supportsAllDrives

uploadType

string

针对 /upload URI 的上传请求的类型。如果您要使用 /upload URI 上传数据,则必须填写该字段。如果您要创建仅包含元数据的文件,则不需要填写该字段。此外,该字段不会显示在“试用此方法”微件中,因为此微件不支持上传数据。

可接受的值包括:

  • media - 简单上传。仅上传媒体,不涉及任何元数据。
  • multipart - 分段上传。在单个请求中同时上传媒体及其元数据。
  • resumable - 可续传上传。以可续传的方式上传文件,使用至少包含两个请求的一系列请求(其中第一个请求包含元数据)。
useContentAsIndexableText

boolean

是否将上传的内容用作可编入索引的文本。

includePermissionsForView

string

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

includeLabels

string

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

请求正文

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

响应正文

如果成功,则响应正文包含一个 File 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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