REST Resource: revisions
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:修订版本
文件修订版本的元数据。
某些资源方法(例如 revisions.update
)需要 revisionId
。使用 revisions.list
方法检索修订版本的 ID。
JSON 表示法 |
{
"exportLinks": {
string: string,
...
},
"id": string,
"mimeType": string,
"kind": string,
"published": boolean,
"keepForever": boolean,
"md5Checksum": string,
"modifiedTime": string,
"publishAuto": boolean,
"publishedOutsideDomain": boolean,
"publishedLink": string,
"size": string,
"originalFilename": string,
"lastModifyingUser": {
object (User )
}
} |
字段 |
exportLinks |
map (key: string, value: string)
仅限输出。用于将 Google 文档编辑器文件导出为特定格式的链接。 包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" } 。
|
id |
string
仅限输出。修订版本的 ID。
|
mimeType |
string
仅限输出。修订版本的 MIME 类型。
|
kind |
string
仅限输出。表明这是哪类资源。值:固定字符串 "drive#revision" 。
|
published |
boolean
相应修订版本是否已发布。此功能仅适用于 Google 文档编辑器文件。
|
keepForever |
boolean
是否永久保留此修订版本,即使它不再是头部修订版本。如果未设置,系统会在上传新内容 30 天后自动清除相应修订版本。此属性最多可针对文件的 200 个修订版本进行设置。 此字段仅适用于云端硬盘中包含二进制内容的文件。
|
md5Checksum |
string
仅限输出。相应修订版本内容的 MD5 校验和。此架构仅适用于云端硬盘中的二进制内容文件。
|
modifiedTime |
string
仅限输出。修订版本的上次修改时间(RFC 3339 日期时间)。
|
publishAuto |
boolean
后续修订版本是否会自动重新发布。此功能仅适用于 Google 文档编辑器文件。
|
publishedOutsideDomain |
boolean
相应修订版本是否已发布到网域之外。此功能仅适用于 Google 文档编辑器文件。
|
publishedLink |
string
仅限输出。指向已发布修订版本的链接。系统仅会为 Google 文档编辑器文件填充此字段。
|
size |
string (int64 format)
仅限输出。相应修订版本的内容大小(以字节为单位)。此架构仅适用于云端硬盘中的二进制内容文件。
|
originalFilename |
string
仅限输出。用于创建相应修订版本的原始文件名。此架构仅适用于云端硬盘中的二进制内容文件。
|
lastModifyingUser |
object (User )
仅限输出。上次修改相应修订版本的用户。只有在上次修改是由已登录的用户执行的情况下,系统才会填充此字段。
|
方法 |
|
永久删除文件版本。 |
|
根据 ID 获取修订版本的元数据或内容。 |
|
列出文件的修订版本。 |
|
使用补丁语义更新修订版本。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# REST Resource: revisions\n\n- [Resource: Revision](#Revision)\n - [JSON representation](#Revision.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Revision\n------------------\n\nThe metadata for a revision to a file.\n\nSome resource methods (such as `revisions.update`) require a `revisionId`. Use the `revisions.list` method to retrieve the ID for a revision.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"exportLinks\": { string: string, ... }, \"id\": string, \"mimeType\": string, \"kind\": string, \"published\": boolean, \"keepForever\": boolean, \"md5Checksum\": string, \"modifiedTime\": string, \"publishAuto\": boolean, \"publishedOutsideDomain\": boolean, \"publishedLink\": string, \"size\": string, \"originalFilename\": string, \"lastModifyingUser\": { object (/workspace/drive/api/reference/rest/v3/User) } } ``` |\n\n| Fields ||\n|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `exportLinks` | `map (key: string, value: string)` Output only. Links for exporting Docs Editors files to specific formats. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `id` | `string` Output only. The ID of the revision. |\n| `mimeType` | `string` Output only. The MIME type of the revision. |\n| `kind` | `string` Output only. Identifies what kind of resource this is. Value: the fixed string `\"drive#revision\"`. |\n| `published` | `boolean` Whether this revision is published. This is only applicable to Docs Editors files. |\n| `keepForever` | `boolean` Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive. |\n| `md5Checksum` | `string` Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive. |\n| `modifiedTime` | `string` Output only. The last time the revision was modified (RFC 3339 date-time). |\n| `publishAuto` | `boolean` Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files. |\n| `publishedOutsideDomain` | `boolean` Whether this revision is published outside the domain. This is only applicable to Docs Editors files. |\n| `publishedLink` | `string` Output only. A link to the published revision. This is only populated for Docs Editors files. |\n| `size` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The size of the revision's content in bytes. This is only applicable to files with binary content in Drive. |\n| `originalFilename` | `string` Output only. The original filename used to create this revision. This is only applicable to files with binary content in Drive. |\n| `lastModifyingUser` | `object (`[User](/workspace/drive/api/reference/rest/v3/User)`)` Output only. The last user to modify this revision. This field is only populated when the last modification was performed by a signed-in user. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------|----------------------------------------------|\n| ### [delete](/workspace/drive/api/reference/rest/v3/revisions/delete) | Permanently deletes a file version. |\n| ### [get](/workspace/drive/api/reference/rest/v3/revisions/get) | Gets a revision's metadata or content by ID. |\n| ### [list](/workspace/drive/api/reference/rest/v3/revisions/list) | Lists a file's revisions. |\n| ### [update](/workspace/drive/api/reference/rest/v3/revisions/update) | Updates a revision with patch semantics. |"]]