Google Диск ведет автоматическую историю изменений, которая может помочь пользователям отслеживать изменения файлов и версии контента. В истории изменений пользователи могут видеть, какие изменения были внесены, и могут вернуться к определенной версии файла с определенными изменениями.
Следующие условия относятся к ресурсам изменений и версий Google Drive API:
- Список контроля доступа (ACL)
- Список всех ресурсов разрешений, связанных с файлом, папкой или общим диском.
- Изменять
- Изменение содержимого файла или метаданных файла или общего диска.
- Журнал смены пользователей
- Запись обо всех изменениях, которые пользователь внес в каждый редактируемый файл на своем «Моем диске», например в Документы Google, Таблицы или Презентации. Для участников общего диска журнал изменений пользователей также включает записи о членстве в общем диске, уровнях доступа пользователей к элементам на этом общем диске и изменениях имени общего диска.
- Журнал изменений общего диска
- Запись обо всех изменениях на общем диске, например добавлении или удалении пользователей, а также обо всех изменениях элементов на этом общем диске. Изменение элемента на общем диске отображается как в журнале изменений пользователей, так и в журнале изменений общего диска.
- Изменить запись в журнале
- Запись об изменении содержимого файла или метаданных файла или общего диска. Запись журнала изменений указывает пользователя, внесшего изменение, метку времени и идентификатор. В журнале изменений одновременно может быть только одна запись для каждого файла или общего диска. Каждый раз, когда этот файл или общий диск изменяется, для этой записи создается новый идентификатор, который заменяет предыдущую запись.
- Редакция
- Версия файла, представляющая изменение содержимого файла (не метаданных). Доступ к каждой ревизии можно получить с помощью ресурса Revision в Drive API.
- Ревизия головы
- Самая последняя версия файла.
- Версия BLOB-объекта
Версия неизменяемого двоичного файла, например изображения, видео или PDF. Если редакция большого двоичного объекта является единственной ревизией двоичного файла, ее нельзя удалить. Новый большой двоичный объект можно загрузить как новую редакцию, которая станет новой головной ревизией этого файла.
Для ревизий больших двоичных объектов можно установить значение «Сохранить навсегда», что означает, что редакция не может быть автоматически удалена. Для параметра «Сохранить навсегда» можно установить до 200 редакций. Версия головки никогда не очищается автоматически.
Любая ревизия, кроме главной ревизии, не помеченная как «Сохранить навсегда», подлежит удалению. Очищаемые версии обычно сохраняются в течение 30 дней, но их можно удалить раньше, если в файле имеется 100 ревизий, не помеченных как «Сохранить навсегда», и загружается новая редакция.
Поле
keepForever
ресурсаRevisions
используется для установки редакции «Сохранить навсегда». Кроме того, вы можете вызватьrevisions.delete
чтобы удалить ревизию, даже если она помечена как «Сохранить навсегда».- История изменений
Запись всех редакций файла в хронологическом порядке. Изменение файла Документов, Таблиц или Презентаций получает новую версию. Каждый раз, когда содержимое изменяется, Диск создает новую запись в истории изменений для этого файла. Однако эти версии файла редактора могут быть объединены вместе, поэтому ответ API может не отображать все изменения в файле.
Посмотрите это видео, чтобы узнать, как управлять версиями с помощью Google Drive API:
Следующие шаги
- Чтобы определить, где записывается изменение, которое вы хотите отслеживать, см. раздел Определите, какой журнал изменений следует отслеживать .
- Чтобы настроить отслеживание изменений для пользователей и общих дисков, см. раздел Отслеживание изменений для пользователей и общих дисков .
- Чтобы опубликовать, загрузить или запросить версии, см. раздел Загрузка и публикация версий файлов .
- Чтобы настроить уведомления об изменениях, см. Push-уведомления .