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

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