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

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

keepForever

boolean

是否永久保留此修订版本,即使它不再是主要修订版本。如果未设置,当新内容上传后,修订版本将在 30 天后自动清除。一个文件最多可以设置 200 个修订版本。

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

md5Checksum

string

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

modifiedTime

string

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

publishAuto

boolean

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

publishedOutsideDomain

boolean

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

size

string (int64 format)

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

originalFilename

string

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

lastModifyingUser

object (User)

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

方法

delete

永久删除文件版本。

get

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

list

列出文件的修订版本。

update

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