REST Resource: revisions

• 资源：修订
  • JSON 表示法
• 方法

资源：修订

文件的修订版本。

某些资源方法（例如 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 此修订版本是否已发布。只有 Google 文档编辑器文件才会填充此字段，并且只能修改此字段。
etag	string 仅限输出。修订版本的 ETag。
exportLinks	map (key: string, value: string) 仅限输出。用于将 Google 文档编辑器文件导出为特定格式的链接。 包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
pinned	boolean 此修订版本是否已固定以防止自动清除。如果未设置，系统会在上传较新内容 30 天后自动清除修订版本。只有内容存储在云端硬盘中的文件（文档编辑器文件除外）才能修改此字段。您还可以在通过 drive.files.insert/update/copy 创建修订版本时使用固定的查询参数将其固定。已固定的修订版本会使用额外的存储配额无限期存储，最多可存储 200 个修订版本。
md5Checksum	string 仅限输出。此修订版本内容的 MD5 校验和。只有内容存储在云端硬盘中的文件才会填充此字段。
modifiedDate	string 仅限输出。上次修改此修订版本的时间（采用 RFC 3339 时间戳格式）。
lastModifyingUserName	string 仅限输出。上次修改此修订版本的用户的姓名。
downloadUrl	string 仅限输出。文件的短期下载网址。只有内容存储在云端硬盘中的文件才会填充此字段。
publishAuto	boolean 是否自动重新发布后续修订版本。只有 Google 文档编辑器文件才会填充此字段，并且只能修改此字段。
publishedOutsideDomain	boolean 此修订版本是否已发布到网域之外。只有 Google 文档编辑器文件才会填充此字段，并且只能修改此字段。
publishedLink	string 仅限输出。指向已发布修订版本的链接。此字段仅针对 Google 文档编辑器文件填充。
fileSize	string (int64 format) 仅限输出。修订版的大小（以字节为单位）。只有内容存储在云端硬盘中的文件才会填充此字段。
originalFilename	string 仅限输出。此修订版本创建时的原始文件名。只有内容存储在云端硬盘中的文件才会填充此字段。
lastModifyingUser	object (User) 仅限输出。上次修改此修订版本的用户。只有当上次修改由已登录的用户执行时，系统才会填充此字段。
selfLink	string 仅限输出。指向此修订版本的链接。

方法
delete	永久删除文件版本。
get	获取特定修订版本。
list	列出文件的修订版本。
patch	更新修订版。
update	更新修订版。