Method: files.update

更新文件的元数据和/或内容。调用此方法时,请仅填充您要修改的请求中的字段。更新字段时,某些字段可能会自动更改,例如 modifiedDate。此方法支持补丁语义。

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

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

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

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
uploadType

string

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

可接受的值为:

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

string

文件的 ID。

查询参数

参数
uploadType

string

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

可接受的值为:

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

string

要添加的父级 ID 的逗号分隔列表。

enforceSingleParent
(deprecated)

boolean

已弃用:系统不再支持向多个文件夹添加文件。请改用快捷键。

keepRevisionForever

boolean

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

ocrLanguage

string

图片导入期间 OCR 处理的语言提示(ISO 639-1 代码)。

removeParents

string

要移除的父级 ID 的列表(以英文逗号分隔)。

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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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