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

更新修订版本。