변경사항 및 버전 개요

Google Drive는 수정 기록을 자동으로 유지하므로 사용자가 파일 변경사항 및 콘텐츠 버전을 추적할 수 있습니다. 업데이트 기록에서 사용자는 어떤 수정이 이루어졌는지 확인할 수 있으며 특정 수정사항이 있는 파일의 특정 버전으로 되돌릴 수 있습니다.

다음은 Google Drive API의 변경사항 및 버전 리소스와 관련된 용어입니다.

액세스제어 목록 (ACL)
파일, 폴더 또는 공유 드라이브와 연결된 모든 권한 리소스의 목록입니다.
변경
파일 콘텐츠 또는 파일 또는 공유 드라이브의 메타데이터 변경입니다.
사용자 변경 로그
Google Docs, Sheets, Slides 등 사용자가 내 드라이브에서 수정 가능한 모든 파일에 적용한 모든 변경사항의 레코드 공유 드라이브 멤버의 사용자 변경 로그에는 공유 드라이브 멤버십, 해당 공유 드라이브 항목에 대한 사용자 액세스 수준, 공유 드라이브 이름 변경에 대한 항목도 포함됩니다.
공유 드라이브 변경 로그
공유 드라이브의 모든 변경사항(예: 사용자 추가 또는 삭제)과 공유 드라이브 항목의 모든 변경사항에 관한 레코드 공유 드라이브 내 항목 변경사항은 사용자 변경 로그와 공유 드라이브 변경 로그에 모두 표시됩니다.
로그 항목 변경
파일 콘텐츠 또는 파일 또는 공유 드라이브의 메타데이터 변경사항의 기록입니다. 변경 로그 항목은 변경한 사용자, 타임스탬프, ID를 나타냅니다. 변경 로그에는 파일 또는 공유 드라이브당 한 번에 하나의 항목만 있을 수 있습니다. 파일 또는 공유 드라이브가 변경될 때마다 해당 항목의 새 ID가 생성되어 이전 항목을 대체합니다.
버전
파일의 콘텐츠 변경사항 (메타데이터가 아님)을 나타내는 파일의 버전입니다. 각 버전은 Drive API 내의 버전 리소스를 사용하여 액세스할 수 있습니다.
헤드 버전
파일의 최신 버전입니다.
Blob 버전

수정할 수 없는 바이너리 파일 버전(예: 이미지, 동영상, PDF)입니다. blob 버전이 바이너리 파일의 유일한 버전이면 삭제할 수 없습니다. 새 blob을 새 버전으로 업로드할 수 있으며, 이 업로드가 해당 파일의 새로운 헤드 버전이 됩니다.

Blob 버전을 '영구 유지'로 설정할 수 있으며, 이는 버전을 자동으로 삭제할 수 없음을 의미합니다. '영구 보관'으로 최대 200개의 버전을 설정할 수 있습니다. 헤드 버전은 자동으로 삭제되지 않습니다.

헤드 수정 외에 '영구 유지'로 지정되지 않은 모든 수정본은 삭제할 수 있습니다. 삭제 가능한 버전은 일반적으로 30일 동안 보존되지만, 파일에 '영구 유지'로 지정되지 않은 버전이 100개 있고 새 버전이 업로드되는 경우에는 더 일찍 영구 삭제될 수 있습니다.

Revisions 리소스의 keepForever 필드는 버전을 'Keep Forever'로 설정하는 데 사용됩니다. 또한 revisions.delete를 호출하여 'Keep Forever'로 표시된 경우에도 버전을 삭제할 수 있습니다.

업데이트 기록

파일의 모든 수정 버전을 시간순으로 기록한 레코드입니다. Docs, Sheets, Slides 파일이 변경되면 새 버전이 적용됩니다. 콘텐츠가 변경될 때마다 Drive에서 해당 파일에 대한 새 업데이트 기록 항목을 만듭니다. 그러나 이러한 편집기 파일 버전은 함께 병합될 수 있으므로 API 응답이 파일의 모든 변경사항을 표시하지 않을 수도 있습니다.

Google Drive API를 사용하여 버전을 관리하는 방법을 알아보려면 다음 동영상을 시청하세요.

다음 단계