Method: files.create

创建新文件。

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

  • 文件大小上限：5,120 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 转码语法。

查询参数

参数
enforceSingleParent

boolean

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

boolean

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

boolean

是否在新主分支修订版中设置“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

指定要在响应中包含哪些其他视图的权限。仅支持“已发布”。
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

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