REST Resource: revisions
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Revision
Siêu dữ liệu cho một phiên bản của tệp.
Một số phương thức tài nguyên (chẳng hạn như revisions.update
) yêu cầu có revisionId
. Sử dụng phương thức revisions.list
để truy xuất mã nhận dạng cho một bản sửa đổi.
Biểu diễn dưới dạng 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 )
}
} |
Trường |
exportLinks |
map (key: string, value: string)
Chỉ có đầu ra. Đường liên kết để xuất tệp của Trình chỉnh sửa tài liệu sang các định dạng cụ thể. Một đối tượng chứa danh sách các cặp "key": value . Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" } .
|
id |
string
Chỉ có đầu ra. Mã của bản sửa đổi.
|
mimeType |
string
Chỉ có đầu ra. Loại MIME của bản sửa đổi.
|
kind |
string
Chỉ có đầu ra. Xác định loại tài nguyên này. Giá trị: chuỗi cố định "drive#revision" .
|
published |
boolean
Bản sửa đổi này đã được xuất bản hay chưa. Điều này chỉ áp dụng cho các tệp của Trình chỉnh sửa Tài liệu.
|
keepForever |
boolean
Có giữ lại bản sửa đổi này vĩnh viễn hay không, ngay cả khi bản sửa đổi này không còn là bản sửa đổi chính nữa. Nếu bạn không đặt thời gian lưu giữ, thì bản sửa đổi sẽ tự động bị xoá sau 30 ngày kể từ khi nội dung mới hơn được tải lên. Bạn có thể đặt chế độ này cho tối đa 200 phiên bản của một tệp. Trường này chỉ áp dụng cho các tệp có nội dung nhị phân trong Drive.
|
md5Checksum |
string
Chỉ có đầu ra. Tổng kiểm MD5 của nội dung bản sửa đổi. Điều này chỉ áp dụng cho các tệp có nội dung nhị phân trong Drive.
|
modifiedTime |
string
Chỉ có đầu ra. Lần gần đây nhất bản sửa đổi được chỉnh sửa (ngày giờ theo RFC 3339).
|
publishAuto |
boolean
Liệu các bản sửa đổi tiếp theo có được tự động xuất bản lại hay không. Điều này chỉ áp dụng cho các tệp của Trình chỉnh sửa Tài liệu.
|
publishedOutsideDomain |
boolean
Bản sửa đổi này có được xuất bản bên ngoài miền hay không. Điều này chỉ áp dụng cho các tệp của Trình chỉnh sửa Tài liệu.
|
publishedLink |
string
Chỉ có đầu ra. Đường liên kết đến bản sửa đổi đã xuất bản. Tham số này chỉ được điền sẵn cho các tệp của Trình chỉnh sửa Tài liệu.
|
size |
string (int64 format)
Chỉ có đầu ra. Dung lượng nội dung của bản sửa đổi tính bằng byte. Điều này chỉ áp dụng cho các tệp có nội dung nhị phân trong Drive.
|
originalFilename |
string
Chỉ có đầu ra. Tên tệp gốc dùng để tạo bản sửa đổi này. Điều này chỉ áp dụng cho các tệp có nội dung nhị phân trong Drive.
|
lastModifyingUser |
object (User )
Chỉ có đầu ra. Người dùng đã sửa đổi bản sửa đổi này lần gần nhất. Trường này chỉ được điền sẵn khi người dùng đã đăng nhập thực hiện lần sửa đổi gần đây nhất.
|
Phương thức |
|
Xoá vĩnh viễn một phiên bản tệp. |
|
Lấy siêu dữ liệu hoặc nội dung của một bản sửa đổi theo mã nhận dạng. |
|
Liệt kê các bản sửa đổi của một tệp. |
|
Cập nhật một bản sửa đổi bằng ngữ nghĩa của bản vá. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],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. |"]]