Google Drive API는 파일 버전을 다운로드하고 게시할 수 있도록 revisions 리소스를 제공합니다. 버전 용어에 관한 자세한 내용은 변경사항 및 버전 개요를 참고하세요.
이 가이드에서는 Google Drive API를 사용하여 파일 버전을 관리하는 방법을 설명합니다.
자동 삭제에서 제외할 버전 지정
Google Drive는 사용자에게 더 이상 필요하지 않은 이전 버전을 자동으로 삭제합니다.
blob 파일 버전을 '영구 보관'으로 설정할 수 있습니다. 즉, 버전을 자동으로 삭제할 수 없습니다. 최대 200개의 버전이 '영구 보관'으로 설정될 수 있으며 스토리지 한도에 포함됩니다. 헤드 버전은 자동으로 삭제되지 않습니다.
헤드 버전을 제외하고 '영구 보관'으로 지정되지 않은 모든 blob 파일 버전은 삭제할 수 있습니다. 삭제 가능한 버전은 일반적으로 30일 동안 보관되지만, 파일에 '영구 보관'으로 지정되지 않은 버전이 100개 있고 새 버전이 업로드된 경우 더 일찍 삭제될 수 있습니다.
revisions 리소스의 불리언 keepForever 필드를 true로 설정하여 Drive에서 삭제하지 않으려는 버전을 표시할 수 있습니다. 블롭 파일 버전이 '영원히 보관'으로 설정되면 다운로드하거나 삭제만 할 수 있습니다. 자세한 내용은 버전 다운로드 또는 버전 삭제를 참고하세요.
버전 다운로드
'영구 보관'으로 표시된 blob 파일 콘텐츠 수정사항만 다운로드할 수 있습니다. 수정 버전을 다운로드하려면 먼저 '영구 보관'으로 설정해야 합니다. 자세한 내용은 자동 삭제에서 저장할 버전 지정을 참고하세요.
blob 파일 콘텐츠 수정사항을 다운로드하거나 Google Workspace 문서 콘텐츠 수정사항을 내보내려면 파일 다운로드 및 내보내기를 참고하세요.
버전 삭제
'영구 보관'으로 표시된 경우에도 revisions.delete 메서드를 호출하여 blob 파일 수정사항을 영구적으로 삭제할 수 있습니다.
이전 Drive API v2를 사용하는 경우 revisions 리소스의 pinned 필드를 대신 사용합니다.
버전 게시
Google Docs, Google Sheets, Google Slides 수정 버전을 게시하려면 revisions 리소스에서 해당 파일의 published 속성을 설정하세요. Drive API를 사용하여 Google Sites 버전의 이 속성을 설정할 수 없습니다.
Google Slides 및 Google Drawings에서는 특정 버전의 게시를 지원하지 않습니다. 최신 버전의 자동 재게시만 지원됩니다. 프레젠테이션과 그림을 게시하려면 publishAuto을 true로 설정합니다.
파일이 Google Workspace 도메인에서 생성된 경우 publishedOutsideDomain 속성은 수정 버전에 모든 사용자가 액세스할 수 있는지 아니면 도메인 사용자로 제한되는지를 나타냅니다. 사이트 파일의 경우 이 속성은 type=anyone 권한이 있는지 여부를 나타냅니다. 자세한 내용은 permissions 리소스의 type 필드를 참고하세요.
publishAuto 속성이 설정되지 않으면 게시된 버전에 파일에 적용된 변경사항이 반영되지 않습니다. 속성이 true로 설정되면 파일의 최신 버전이 자동으로 게시되어 이전 버전을 덮어씁니다.
슬라이드와 그림은 자동 재게시만 지원하며 publishAuto 속성이 true로 설정되어야 합니다. 사이트 파일의 경우 publishAuto는 항상 false입니다.
자동 게시 기능은 Docs 및 Sheets의 UI에 있는 '파일이 수정되면 자동으로 다시 게시' 체크박스로도 제어할 수 있습니다. 자세한 내용은 Google Docs, Sheets, Slides, Forms를 공개로 설정하기를 참고하세요.