- 资源:Revision
<ph type="x-smartling-placeholder">
- </ph>
- 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 ( |
字段 | |
---|---|
id |
仅限输出。修订版本的 ID。 |
mimeType |
仅限输出。修订版本的 MIME 类型。 |
kind |
仅限输出。始终为 |
published |
此修订版本是否已发布。系统只会为文档编辑器文件填充此字段,并且只能修改此字段。 |
etag |
仅限输出。修订版本的 ETag。 |
exportLinks |
仅限输出。用于将文档编辑器文件导出为特定格式的链接。 包含一系列 |
pinned |
是否固定此修订版本以防止自动完全清除。如果您未设置此政策,当新内容上传后,修订版本会在 30 天后自动完全清除。您只能对包含存储在云端硬盘中的文件的文件(不包括文档编辑器文件)修改此字段。当通过 drive.files.insert/update/copy 创建修订版本时,也可以使用固定的查询参数将其固定。使用额外存储空间配额可以无限期存储固定的修订版本,最多 200 个修订版本。 |
md5Checksum |
仅限输出。此修订版本内容的 MD5 校验和。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。 |
modifiedDate |
仅限输出。上次修改此修订版本的时间(采用 RFC 3339 时间戳格式)。 |
lastModifyingUserName |
仅限输出。最后修改此修订版本的用户的名称。 |
downloadUrl |
仅限输出。文件的短期下载网址。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。 |
publishAuto |
是否会自动重新发布后续修订版本。系统只会为文档编辑器文件填充此字段,并且只能修改此字段。 |
publishedOutsideDomain |
此修订版本是否发布在网域外。系统只会为文档编辑器文件填充此字段,并且只能修改此字段。 |
publishedLink |
仅限输出。指向已发布修订版本的链接。系统只会针对 Google 协作平台文件填充此字段。 |
fileSize |
仅限输出。修订版本的大小(以字节为单位)。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。 |
originalFilename |
仅限输出。创建此修订版本时的原始文件名。系统只会为包含存储在云端硬盘中的内容的文件填充此字段。 |
lastModifyingUser |
仅限输出。最后一个修改此修订版本的用户。仅当上次修改是由已登录的用户执行时,系统才会填充此字段。 |
selfLink |
仅限输出。返回此修订版本的链接。 |
方法 |
|
---|---|
|
永久删除文件版本。 |
|
获取特定修订版本。 |
|
列出文件的修订版本。 |
|
更新修订版本。 |
|
更新修订版本。 |