API Google Drive предоставляет ресурс, позволяющий загружать и публиковать revisions файлов. Подробнее о терминологии, связанной с ревизиями, см. в разделе «Обзор изменений и ревизий» .
В этом руководстве объясняется, как управлять версиями файлов с помощью API Google Диска.
Укажите версии, которые необходимо сохранить от автоматического удаления
Google Drive автоматически удаляет старые версии, которые больше не представляют интереса для пользователя.
Для ревизии BLOB -файла можно установить значение «Хранить вечно», что означает, что она не будет автоматически удалена. Можно установить значение «Хранить вечно» для до 200 ревизий, которые будут учитываться при расчете лимита хранилища. Ревизия заголовка никогда не удаляется автоматически.
Любая ревизия BLOB-файла, кроме главной, не отмеченная как «Хранить вечно», может быть удалена. Удаляемые ревизии обычно хранятся в течение 30 дней, но могут быть удалены и раньше, если файл содержит 100 ревизий, не отмеченных как «Хранить вечно», и загружена новая ревизия.
Вы можете установить логическое поле keepForever ресурса revisions в значение true , чтобы отметить те версии, которые вы не хотите удалять с Диска. После того, как для версии BLOB-файла установлено значение «Хранить вечно», её можно только загрузить или удалить. Подробнее см. в разделах Загрузка версии и Удаление версии .
Загрузить версию
Вы можете загрузить только версии содержимого BLOB-файла, отмеченные как «Сохранить навсегда». Если вы хотите загрузить версию, сначала убедитесь, что она отмечена как «Сохранить навсегда». Подробнее см. в разделе «Указание версий для сохранения от автоматического удаления» .
Чтобы загрузить версию содержимого файла BLOB-объекта или экспортировать версию содержимого документа Google Workspace, см. раздел Загрузка и экспорт файлов .
Удалить ревизию
Метод revisions.delete можно вызвать для окончательного удаления ревизии файла BLOB-объекта, даже если она помечена как «Сохранить навсегда».
Если вы используете старую версию Drive API v2, используйте вместо нее pinned поле ресурса revisions .
Опубликовать пересмотр
Чтобы опубликовать версию Google Docs, Google Sheets и Google Slides, задайте свойство published для этого файла в ресурсе revisions . Это свойство невозможно задать для версий Google Sites с помощью Drive API.
Google Презентации и Google Рисунки не поддерживают публикацию отдельных версий. Поддерживается только автоматическая повторная публикация последней версии. Чтобы опубликовать слайды и рисунки, также установите для publishAuto значение true .
Если файл создан в домене Google Workspace, свойство publishedOutsideDomain указывает, доступна ли эта версия всем или только пользователям домена. Для файлов Sites это свойство указывает, существует ли разрешение type=anyone . Подробнее см. в поле type ресурса permissions .
Опубликованные версии не отражают изменения, внесённые в файл, если не задано свойство publishAuto . Если свойство имеет значение true , новые версии файла автоматически публикуются, перезаписывая предыдущие. Слайды и рисунки поддерживают только автоматическую повторную публикацию и требуют, чтобы свойство publishAuto было задано как true . Для файлов Sites свойство publishAuto всегда имеет false .
Автоматическая публикация также контролируется флажком «Автоматически перепубликовать при внесении изменений» в интерфейсе Документов и Таблиц. Подробнее см. в статье «Сделать Google Документы, Таблицы, Презентации и Формы общедоступными ».