Google Drive는 사용자가 파일 변경사항과 콘텐츠 수정을 추적하는 데 도움이 되는 자동 수정 내역을 유지합니다. 사용자는 업데이트 기록에서 어떤 수정사항이 적용되었는지 확인하고 특정 수정사항이 적용된 파일의 특정 버전으로 되돌릴 수 있습니다.
다음 용어는 Google Drive API의 변경사항 및 버전 리소스와 관련이 있습니다.
- 액세스 제어 목록 (ACL)
- 파일, 폴더 또는 공유 드라이브와 연결된 모든 권한 리소스의 목록입니다.
- 변경
- 파일의 콘텐츠 또는 파일 또는 공유 드라이브의 메타데이터에 적용된 변경사항입니다.
- 사용자 변경 로그
- 사용자가 내 드라이브의 수정 가능한 모든 파일(예: Google Docs, Sheets, Slides)에 대해 적용한 모든 변경사항의 기록입니다. 공유 드라이브의 멤버의 경우 사용자 변경 로그에 공유 드라이브 멤버십, 해당 공유 드라이브의 항목에 대한 사용자 액세스 수준, 공유 드라이브 이름 변경에 관한 항목도 포함됩니다.
- 공유 드라이브 변경 로그
- 사용자 추가 또는 삭제와 같은 공유 드라이브의 모든 변경사항 및 해당 공유 드라이브의 항목에 대한 모든 변경사항의 기록입니다. 공유 드라이브 내 항목의 변경사항은 사용자 변경 로그와 공유 드라이브 변경 로그에 모두 표시됩니다.
- 변경 로그 항목
- 파일의 콘텐츠 또는 파일 또는 공유 드라이브의 메타데이터에 적용된 변경사항의 기록입니다. 변경 로그 항목은 변경한 사용자, 타임스탬프, ID를 나타냅니다. 변경 로그에는 파일 또는 공유 드라이브당 한 번에 하나의 항목만 있을 수 있습니다. 파일 또는 공유 드라이브가 변경될 때마다 해당 항목의 새 ID가 생성되어 이전 항목을 대체합니다.
- 버전
- 파일의 콘텐츠 (메타데이터 아님) 변경사항을 나타내는 파일 버전입니다. 각 버전은 Drive API 내의 버전 리소스를 사용하여 액세스할 수 있습니다.
- 헤드 수정
- 파일의 최신 버전입니다.
- Blob 버전
이미지, 동영상, PDF와 같이 수정할 수 없는 바이너리 파일의 버전입니다. blob 버전이 바이너리 파일의 유일한 버전인 경우 삭제할 수 없습니다. 새 blob을 새 버전으로 업로드할 수 있으며 이는 해당 파일의 새 헤드 버전이 됩니다.
Blob 버전은 'Keep Forever'(영구 보관)로 설정할 수 있습니다. 즉, 버전이 자동으로 삭제되지 않습니다. 최대 200개의 버전을 '영구 보관'으로 설정할 수 있습니다. 헤드 버전은 자동으로 삭제되지 않습니다.
'Keep Forever'로 지정되지 않은 헤드 버전 이외의 모든 버전은 삭제할 수 있습니다. 삭제 가능한 버전은 일반적으로 30일 동안 보관되지만, 파일에 '영구 보관'으로 지정되지 않은 버전이 100개 있고 새 버전이 업로드되면 더 일찍 삭제될 수 있습니다.
Revisions
리소스의keepForever
필드는 버전을 'Keep Forever'(영구 보관)로 설정하는 데 사용됩니다. 또한revisions.delete
를 호출하여 '영구 보관'으로 표시된 버전도 삭제할 수 있습니다.- 업데이트 기록
시간순으로 나열된 파일 내 모든 수정 버전 기록입니다. Docs, Sheets, Slides 파일이 변경되면 새 버전이 적용됩니다. 콘텐츠가 변경될 때마다 Drive는 해당 파일의 새 버전 기록 항목을 만듭니다. 그러나 이러한 편집기 파일 버전은 병합될 수 있으므로 API 응답에 파일의 모든 변경사항이 표시되지 않을 수 있습니다.
Google Drive API로 버전을 관리하는 방법을 알아보려면 이 동영상을 시청하세요.
다음 단계
- 추적하려는 변경사항이 기록되는 위치를 확인하려면 추적할 변경 로그 식별을 참고하세요.
- 사용자 및 공유 드라이브의 변경 추적을 설정하려면 사용자 및 공유 드라이브의 변경사항 추적을 참고하세요.
- 버전을 게시, 다운로드 또는 쿼리하려면 파일 버전 다운로드 및 게시를 참조하세요.
- 변경 알림을 설정하려면 푸시 알림을 참고하세요.