Method: files.insert

插入新文件。

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

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

查询参数

参数
convert

boolean

是否将此文件转换为相应的 Google 文档编辑器格式。
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

字幕轨道名称。
uploadType

string

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

可接受的值包括：

  • media - 简单上传。仅上传媒体，不涉及任何元数据。
  • multipart - 多部分上传。在单个请求中同时上传媒体及其元数据。
  • resumable - 可续传上传。以可续传的方式上传文件，使用至少包含两个请求的一系列请求（其中第一个请求包含元数据）。
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

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