REST Resource: revisions

资源:修订版本

文件的修订版本。

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

JSON 表示法
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": string,
  "exportLinks": {
    string: string,
    ...
  },
  "pinned": boolean,
  "md5Checksum": string,
  "modifiedDate": string,
  "lastModifyingUserName": string,
  "downloadUrl": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "fileSize": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  },
  "selfLink": string
}
字段
id

string

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

mimeType

string

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

kind

string

仅限输出。始终为 drive#revision

published

boolean

此修订版本是否已发布。系统只会为文档编辑器文件填充此字段,并且只能修改此字段。

etag

string

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

pinned

boolean

是否固定此修订版本以防止自动完全清除。如果您未设置此政策,当新内容上传后,修订版本会在 30 天后自动完全清除。您只能对包含存储在云端硬盘中的文件的文件(不包括文档编辑器文件)修改此字段。当通过 drive.files.insert/update/copy 创建修订版本时,也可以使用固定的查询参数将其固定。使用额外存储空间配额可以无限期存储固定的修订版本,最多 200 个修订版本。

md5Checksum

string

仅限输出。此修订版本内容的 MD5 校验和。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。

modifiedDate

string

仅限输出。上次修改此修订版本的时间(采用 RFC 3339 时间戳格式)。

lastModifyingUserName

string

仅限输出。最后修改此修订版本的用户的名称。

downloadUrl

string

仅限输出。文件的短期下载网址。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。

publishAuto

boolean

是否会自动重新发布后续修订版本。系统只会为文档编辑器文件填充此字段,并且只能修改此字段。

publishedOutsideDomain

boolean

此修订版本是否发布在网域外。系统只会为文档编辑器文件填充此字段,并且只能修改此字段。

fileSize

string (int64 format)

仅限输出。修订版本的大小(以字节为单位)。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。

originalFilename

string

仅限输出。创建此修订版本时的原始文件名。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。

lastModifyingUser

object (User)

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

方法

delete

永久删除文件版本。

get

获取特定修订版本。

list

列出文件的修订版本。

patch

更新修订版本。

update

更新修订版本。