Method: files.create

创建新文件。

此方法支持 /upload URI，并接受具有以下特征的已上传媒体：

  • 文件大小上限：5120 GB
  • 接受的媒体 MIME 类型：*/*

注意：请指定有效的 MIME 类型，而不是字面量 */* 值。字面量 */* 仅用于指明可以上传任何有效的 MIME 类型。

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

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

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

后续 GET 请求包括只读 fileExtension 属性，其中填充了最初在 title 属性中指定的扩展。当 Google 云端硬盘用户请求下载文件时，或者通过同步客户端下载文件时，云端硬盘会根据文件标题生成一个完整的文件名（带扩展名）。如果缺少扩展名，云端硬盘会尝试根据文件的 MIME 类型来确定扩展名。

HTTP 请求

  • 上传 URI，用于媒体上传请求：
    POST https://www.googleapis.com/upload/drive/v3/files
  • 元数据 URI，适用于仅包含元数据的请求：
    POST https://www.googleapis.com/drive/v3/files

网址采用 gRPC 转码语法。

查询参数

参数
uploadType

string

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

可接受的值包括：

  • media - 简单上传。仅上传媒体内容，不要上传任何元数据。
  • multipart - 多部分上传。在单个请求中同时上传媒体内容及其元数据。
  • resumable - 可续传上传。以可续传的方式上传文件，使用至少两个请求（其中第一个请求包含元数据）进行请求。
enforceSingleParent

boolean

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

boolean

对于指定的文件，是否忽略网域的默认公开范围设置。默认情况下，网域管理员可以选择让所有上传的文件都对网域可见；此参数会绕过相应请求的行为。权限仍继承自父文件夹。
keepRevisionForever

boolean

是否在新标头修订版本中设置“keepForever”字段。这仅适用于 Google 云端硬盘中包含二进制内容的文件。只能永久保留该文件的 200 个修订版本。如果已达到上限，请尝试删除已固定的修订版本。
ocrLanguage

string

在图片导入期间提供的 OCR 处理语言提示（ISO 639-1 代码）。
supportsAllDrives

boolean

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

boolean

已弃用：请改用 supportsAllDrives。
useContentAsIndexableText

boolean

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

string

指定在响应中包含哪些其他视图的权限。仅支持“已发布”。
includeLabels

string

要添加到响应的 labelInfo 部分中的标签 ID 列表（以英文逗号分隔）。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围之一：

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

某些范围是受限的，需要对应用进行安全性评估才能使用它们。如需了解详情，请参阅授权指南。