Google Drive API предоставляет ресурс «Редакции» , позволяющий загружать и публиковать версии файлов. Дополнительные сведения о терминологии версий см. в разделе Обзор изменений и версий .
Укажите версии, которые необходимо сохранить от автоматического удаления
Google Диск автоматически удаляет старые версии, которые больше не представляют интереса для пользователя. Чтобы этого не произошло, вы можете установить для логического флага keepRevisionForever
значение true
, чтобы отметить ревизии, которые вы не хотите удалять с Диска.
Скачать версию
Вы можете использовать значение поля headRevisionId
из ресурса Files , чтобы загрузить последнюю версию. При этом будет получена версия, соответствующая метаданным файла, который вы получили ранее. Чтобы загрузить данные для всех предыдущих ревизий файла, которые все еще хранятся в облаке, вы можете вызвать revisions.list
, который получает все идентификаторы ревизий.
Чтобы загрузить содержимое ревизии, вам необходимо вызвать метод revisions.get
с параметром alt=media
. Версии Google Docs, Sheets и Slides скачать невозможно.
В документах Google, рисунках Google и слайдах номера версий автоматически увеличиваются. Однако в случае удаления редакций в рядах номеров могут быть пробелы, поэтому при получении редакций не следует полагаться на последовательные номера.
Опубликовать версию
Чтобы опубликовать версию Документов, Таблиц и Презентаций Google, вы устанавливаете published
свойство для этого файла в свойстве «Редакции» . Это свойство нельзя установить для версий Google Сайтов через Drive API.
Если файл создан в домене Google Workspace , publishedOutsideDomain
указывает, доступна ли редакция кому-либо или она доступна только пользователям домена. Для файлов Сайтов Google это свойство указывает, существует ли разрешение type=anyone
.
Опубликованные версии не отражают изменения, внесенные в файл, если не установлено publishAuto
. Если для этого свойства установлено значение true, новые версии файла будут автоматически публиковаться, перезаписывая предыдущие. Это поведение также контролируется флажком «Автоматически повторно публиковать при внесении изменений» в пользовательском интерфейсе Диска. Для файлов Google Sites publishAuto
всегда имеет значение false
.