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