Method: files.patch

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

HTTP 请求

PATCH https://www.googleapis.com/drive/v2/files/{fileId}

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

要更新的文件的 ID。

查询参数

参数
addParents

string

要添加的父级 ID 的逗号分隔列表。
convert
(deprecated)

boolean

已废弃：此参数没有任何用途。
enforceSingleParent
(deprecated)

boolean

已弃用：不再支持将文件添加到多个文件夹。请改用 shortcuts。
modifiedDateBehavior

enum (ModifiedDateBehavior)

确定更新 modifiedDate 的行为。这会替换 setModifiedDate。
newRevision

boolean

是否应为 blob 上传内容创建新修订版。如果为 false，则会替换当前主分支修订版中的 blob 数据。如果为 true 或未设置，系统会创建一个新 blob 作为主分支修订版本，并将之前未固定的修订版本保留一小段时间。已固定的修订版本会无限期存储，并使用额外的存储配额，最多可存储 200 个修订版本。如需详细了解修订版本的保留方式，请参阅 云端硬盘帮助中心。请注意，如果请求中没有载荷，系统会忽略此字段。
ocr

boolean

是否尝试对上传的 .jpg、.png、.gif 或 .pdf 文件进行光学字符识别 (OCR)。
ocrLanguage

string

如果 ocr 为 true，则提示要使用的语言。有效值为 BCP 47 代码。
pinned

boolean

是否固定新修订版本。文件最多可以有 200 个固定修订版本。请注意，如果请求中没有载荷，系统会忽略此字段。
removeParents

string

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

boolean

是否使用请求正文中提供的值设置修改日期。将此字段设置为 true 相当于 modifiedDateBehavior=fromBodyOrNow，而 false 相当于 modifiedDateBehavior=now。为防止对修改日期集 modifiedDateBehavior=noChange 进行任何更改。
supportsAllDrives

boolean

请求访问权限的应用是否同时支持“我的云端硬盘”和共享云端硬盘。
supportsTeamDrives
(deprecated)

boolean

已弃用：请改用 supportsAllDrives。
timedTextLanguage

string

字幕的语言。
timedTextTrackName

string

字幕轨道名称。
updateViewedDate

boolean

在成功更新文件后是否更新查看日期。
useContentAsIndexableText

boolean

是否将内容用作可编入索引的文本。
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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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