Method: files.insert

插入新文件。

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

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

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

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

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

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

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

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
uploadType

string

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

可接受的值为:

  • media - 简单上传。仅上传媒体内容,不含任何元数据。
  • multipart - 多部分上传。使用一个请求同时上传媒体及其元数据。
  • resumable - 可续传上传。以可续传的方式上传文件,使用至少两个请求组成的一系列请求,其中第一个请求包含元数据。
convert

boolean

是否将此文件转换为相应的文档编辑器格式。

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

计时文本轨道名称。

useContentAsIndexableText

boolean

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

visibility

enum (Visibility)

新文件的公开范围。此参数仅在 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

某些范围受到限制,您的应用必须接受安全评估才能使用这些范围。有关详情,请参阅授权指南