REST Resource: revisions

资源:修订

文件修订版本的元数据。

某些资源方法(例如 revisions.update)需要 revisionId。使用 revisions.list 方法检索修订版的 ID。

JSON 表示法
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "exportLinks": {
    string: string,
    ...
  },
  "keepForever": boolean,
  "md5Checksum": string,
  "modifiedTime": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "size": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  }
}
字段
id

string

仅限输出。修订版本的 ID。

mimeType

string

仅限输出。修订版本的 MIME 类型。

kind

string

仅限输出。表明这是哪类资源。值:固定字符串 "drive#revision"

published

boolean

此修订版本是否已发布。这仅适用于 Google 文档编辑器文件。

keepForever

boolean

是否永久保留此修订版本,即使它不再是头部修订版本也是如此。如果未设置,系统会在上传较新内容 30 天后自动清除修订版本。您最多可以为文件设置 200 次修订。

此字段仅适用于云端硬盘中包含二进制内容的文件。

md5Checksum

string

仅限输出。修订版内容的 MD5 校验和。此功能仅适用于云端硬盘中包含二进制内容的文件。

modifiedTime

string

仅限输出。修订版上次修改的时间(RFC 3339 日期时间)。

publishAuto

boolean

是否自动重新发布后续修订版本。这仅适用于 Google 文档编辑器文件。

publishedOutsideDomain

boolean

此修订版本是否已发布到网域之外。这仅适用于 Google 文档编辑器文件。

size

string (int64 format)

仅限输出。修订内容的大小(以字节为单位)。此功能仅适用于云端硬盘中包含二进制内容的文件。

originalFilename

string

仅限输出。用于创建此修订版的原始文件名。此功能仅适用于云端硬盘中包含二进制内容的文件。

lastModifyingUser

object (User)

仅限输出。上次修改此修订版本的用户。只有当上次修改由已登录的用户执行时,系统才会填充此字段。

方法

delete

永久删除文件版本。

get

根据 ID 获取修订版的元数据或内容。

list

列出文件的修订版本。

update

使用补丁语义更新修订版。