REST Resource: revisions

资源:修订版本

文件修订版本的元数据。

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

JSON 表示法
{
  "exportLinks": {
    string: string,
    ...
  },
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "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

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