이 가이드에서는 revisions 리소스를 사용하여 파일 버전을 관리하는 방법을 설명합니다(예: 파일 버전 가져오기, Google Workspace 버전 게시). Google Drive API를 사용하면 버전을 다운로드할 수도 있습니다. 버전 용어에 대한 자세한 내용은 변경사항 및 버전 개요를 참고하세요.
업데이트 기록에 액세스하려면 사용자에게 owner, organizer, fileOrganizer 또는 writer의 role 권한이 있어야 합니다.
응답에서 반환할 필드를 지정하려면 revisions 리소스의 메서드를 사용하여 fields
시스템 매개변수를 설정하면 됩니다. 매개변수를 생략하면 서버에서 기본 필드 집합을 반환합니다. 예를 들어 revisions.list 메서드는 id, mimeType, kind, modifiedTime 필드만 반환합니다. 다른 필드를 반환하려면 특정 필드 반환을 참고하세요.
자동 삭제에서 제외할 버전 지정
Google Drive는 사용자에게 더 이상 필요하지 않은 이전 버전을 자동으로 삭제합니다.
blob 파일 버전을 '영구 보관'으로 설정할 수 있습니다. 즉, 버전을 자동으로 삭제할 수 없습니다. 최대 200개의 버전이 '영구 보관'으로 설정될 수 있으며 스토리지 한도에 포함됩니다. 헤드 버전은 자동으로 삭제되지 않습니다.
헤드 버전을 제외하고 '영구 보관'으로 지정되지 않은 모든 blob 파일 버전은 삭제할 수 있습니다. 삭제 가능한 버전은 일반적으로 30일 동안 보관되지만, 파일에 '영구 보관'으로 지정되지 않은 버전이 100개 있고 새 버전이 업로드된 경우 더 일찍 삭제될 수 있습니다.
revisions 리소스의 불리언 keepForever 필드를 true로 설정하여 Drive에서 삭제하지 않으려는 버전을 표시할 수 있습니다. 블롭 파일 버전이 '영원히 보관'으로 설정되면 다운로드하거나 삭제만 할 수 있습니다. 자세한 내용은 버전 다운로드 또는 버전 삭제를 참고하세요.
이전 Drive API v2를 사용하는 경우 keepForever 대신 revisions 리소스의 pinned 필드를 사용하세요.
파일 버전 가져오기
파일 수정 버전의 메타데이터 또는 콘텐츠를 가져오려면 fileId 및 revisionId 경로 매개변수와 함께 revisions 리소스에서 get 메서드를 사용합니다. 버전 ID를 모르는 경우 list 메서드를 사용하여 파일의 모든 버전을 나열할 수 있습니다.
이 메서드는 수정 버전의 메타데이터를 revisions 리소스의 인스턴스로 반환합니다.
알려진 악성 코드 또는 기타 악성 파일을 다운로드할 위험을 확인하려면 acknowledgeAbuse 쿼리 매개변수를 true로 설정합니다. 이 필드는 alt=media 매개변수가 설정되어 있고 사용자가 파일 소유자이거나 파일이 있는 공유 드라이브의 관리자인 경우에만 적용됩니다.
파일의 버전 나열
파일의 버전을 나열하려면 fileId 경로 매개변수와 함께 revisions 리소스에서 list 메서드를 사용합니다. 이 메서드는 파일 수정사항 목록을 반환합니다.
다음 쿼리 매개변수를 전달하여 수정 버전의 페이지로 나누기 또는 필터링을 맞춤설정합니다.
pageSize: 페이지당 반환할 최대 버전 수입니다.pageToken: 이전 목록 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 가져오려면 이 토큰을 제공하세요.
파일 버전 업데이트
파일의 버전을 업데이트하려면 fileId 및 revisionId 경로 매개변수와 함께 revisions 리소스에서 update 메서드를 사용합니다.
이 메서드는 revisions 리소스의 인스턴스를 반환합니다.
버전 다운로드
'영구 보관'으로 표시된 blob 파일 콘텐츠 수정사항만 다운로드할 수 있습니다. 수정 버전을 다운로드하려면 먼저 '영구 보관'으로 설정해야 합니다. 자세한 내용은 자동 삭제에서 저장할 버전 지정을 참고하세요.
blob 파일 콘텐츠 수정사항을 다운로드하거나 Google Workspace 문서 콘텐츠 수정사항을 내보내려면 파일 다운로드 및 내보내기를 참고하세요.
파일 버전 삭제
파일 버전을 영구적으로 삭제하려면 fileId 및 revisionId 경로 매개변수를 사용하여 revisions 리소스에서 delete 메서드를 사용합니다.
이미지, 동영상, PDF와 같이 바이너리 콘텐츠가 포함된 blob 파일의 버전만 삭제할 수 있습니다. 블롭 파일 버전이 '영구 보관'으로 표시된 경우 삭제할 수 있습니다. Google Docs 또는 Sheets와 같은 다른 파일의 버전과 바이너리 파일의 마지막 남은 버전은 삭제할 수 없습니다.
버전 게시
Google Docs, Google Sheets, Google Slides 수정 버전을 게시하려면 revisions 리소스에서 해당 파일의 published 속성을 설정하세요. Drive API를 사용하여 Google Sites 버전의 이 속성을 설정할 수 없습니다.
publishAuto 속성이 설정되지 않으면 게시된 버전에 파일에 적용된 변경사항이 반영되지 않습니다. 속성이 true로 설정되면 파일의 최신 버전이 자동으로 게시되어 이전 버전을 덮어씁니다.
슬라이드와 그림은 자동 재게시만 지원하며 publishAuto 속성이 true로 설정되어야 합니다. 사이트 파일의 경우 publishAuto는 항상 false입니다.
파일이 Google Workspace 도메인에서 생성된 경우 publishedOutsideDomain 속성은 수정 버전에 모든 사용자가 액세스할 수 있는지 아니면 도메인 사용자로 제한되는지 나타냅니다. 사이트 파일의 경우 이 속성은 type=anyone 권한이 있는지 여부를 나타냅니다. 자세한 내용은 permissions 리소스의 type 필드를 참고하세요.
자동 게시 기능은 Docs 및 Sheets의 UI에 있는 '파일이 수정되면 자동으로 다시 게시' 체크박스로도 제어할 수 있습니다. 자세한 내용은 Google Docs, Sheets, Slides, Forms를 공개로 설정하기를 참고하세요.