Google Drive API는 파일 버전을 다운로드하고 게시할 수 있도록 버전 리소스를 제공합니다. 버전 용어에 관한 자세한 내용은 변경사항 및 버전 개요를 참고하세요.
자동 삭제에서 저장할 버전 지정
Google Drive는 사용자가 더 이상 관심이 없는 이전 버전을 자동으로 삭제합니다. 이러한 일이 발생하지 않도록 하려면 부울 플래그 keepRevisionForever를 true로 설정하여 Drive에서 영구 삭제하지 않을 버전을 표시할 수 있습니다.
버전 다운로드
파일 리소스의 headRevisionId 필드 값을 사용하여 최신 버전을 다운로드할 수 있습니다.
이렇게 하면 이전에 검색한 파일의 메타데이터에 상응하는 버전을 가져옵니다. 여전히 클라우드에 저장된 파일의 모든 이전 버전에 대한 데이터를 다운로드하려면 모든 revisionIds를 가져오는 revisions.list를 호출하면 됩니다.
버전 콘텐츠를 다운로드하려면 alt=media 매개변수를 사용하여 revisions.get 메서드를 호출해야 합니다. Google Docs, Sheets, Slides의 버전을 다운로드할 수 없습니다.
Google Docs, Google Drawings, Slides 버전의 경우 버전 번호가 자동으로 증가합니다. 하지만 버전이 삭제되는 경우 일련의 숫자 사이에 공백이 있을 수 있으므로 버전을 검색할 때 순차 번호에 의존해서는 안 됩니다.
버전 게시
Google Docs, Sheets, Slides 버전을 게시하려면 버전 속성에서 해당 파일의 published 속성을 설정하세요. Drive API를 통한 Google Sites 버전의 경우 이 속성을 설정할 수 없습니다.
파일이 Google Workspace 도메인에서 생성된 경우 publishedOutsideDomain 속성은 모든 사용자가 버전에 액세스할 수 있는지 또는 도메인 사용자만 액세스할 수 있는지 여부를 나타냅니다. Google Sites 파일의 경우 이 속성은 type=anyone 권한이 있는지 여부를 나타냅니다.
publishAuto 속성이 설정되지 않으면 게시된 버전은 파일의 변경사항을 반영하지 않습니다. 이 속성을 true로 설정하면 최신 버전의 파일이 자동으로 게시되어 이전 버전을 덮어씁니다. 이 동작은 Drive UI의 '파일이 수정되면 자동으로 다시 게시하기' 체크박스에서도 제어합니다. Google Sites 파일의 경우 publishAuto는 항상 false입니다.