파일 버전 다운로드 및 게시

Google Drive API는 파일 버전을 다운로드하고 게시할 수 있도록 버전 리소스를 제공합니다. 버전 용어에 대한 자세한 내용은 변경사항 및 버전 개요를 참고하세요.

자동 삭제에서 저장할 버전을 지정하세요.

Google Drive는 더 이상 사용자가 관심을 가지지 않는 이전 버전을 자동으로 삭제합니다. 이를 방지하려면 불리언 플래그 keepRevisionForevertrue로 설정하여 Drive에서 영구 삭제되지 않도록 할 버전을 표시합니다.

버전 다운로드

Files 리소스의 headRevisionId 필드 값을 사용하여 최신 버전을 다운로드할 수 있습니다. 그러면 이전에 검색한 파일의 메타데이터에 해당하는 버전을 가져옵니다. 여전히 클라우드에 저장된 파일의 모든 이전 버전 데이터를 다운로드하려면 모든 버전의 ID를 가져오는 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입니다.