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

更新具有补丁语义的修订版本。