REST Resource: revisions
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс: Пересмотр
Метаданные для ревизии файла.
Некоторые методы ресурсов (например, revisions.update
) требуют revisionId
. Используйте метод revisions.list
для получения идентификатора ревизии.
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) Только вывод. Ссылки для экспорта файлов Docs Editors в определённые форматы. Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } . |
id | string Только вывод. Идентификатор ревизии. |
mimeType | string Только вывод. MIME-тип версии. |
kind | string Только вывод. Определяет тип ресурса. Значение: фиксированная строка "drive#revision" . |
published | boolean Опубликована ли эта версия. Это применимо только к файлам Docs Editors. |
keepForever | boolean Сохранять ли эту версию навсегда, даже если она больше не является основной. Если не указано, версия будет автоматически удалена через 30 дней после загрузки нового контента. Можно установить ограничение на количество версий для одного файла: не более 200. Это поле применимо только к файлам с двоичным содержимым на Диске. |
md5Checksum | string Только вывод. Контрольная сумма MD5 содержимого ревизии. Применимо только к файлам с двоичным содержимым на Диске. |
modifiedTime | string Только вывод. Время последнего изменения версии (дата и время RFC 3339). |
publishAuto | boolean Будут ли последующие версии автоматически переиздаваться. Это применимо только к файлам Docs Editors. |
publishedOutsideDomain | boolean Опубликована ли эта версия за пределами домена. Это применимо только к файлам Docs Editors. |
publishedLink | string Только вывод. Ссылка на опубликованную версию. Заполняется только для файлов Docs Editors. |
size | string ( int64 format) Только вывод. Размер содержимого ревизии в байтах. Применимо только к файлам с двоичным содержимым на Диске. |
originalFilename | string Только выходные данные. Исходное имя файла, использованное для создания этой версии. Применимо только к файлам с двоичным содержимым на Диске. |
lastModifyingUser | object ( User ) Только вывод. Последний пользователь, изменивший эту версию. Это поле заполняется только в том случае, если последнее изменение было внесено вошедшим в систему пользователем. |
Методы |
---|
| Безвозвратное удаление версии файла. |
| Получает метаданные или содержимое ревизии по идентификатору. |
| Список версий файла. |
| Обновляет ревизию с использованием семантики патча. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 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. |"]]