파일 버전 다운로드 및 게시

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

자동 삭제로부터 저장할 버전 지정

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

버전 다운로드

파일 리소스의 headRevisionId 필드 값을 사용하여 최신 버전을 다운로드할 수 있습니다. 그러면 이전에 검색한 파일의 메타데이터에 해당하는 버전을 가져옵니다. 여전히 클라우드에 저장된 파일의 모든 이전 버전에 관한 데이터를 다운로드하려면 모든 versionId를 가져오는 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로 설정하면 파일의 최신 버전이 자동으로 게시되어 이전 버전을 덮어씁니다. 이 동작은 '파일이 수정되면 자동으로 다시 게시' 체크박스를 선택합니다. Google Sites 파일의 경우 publishAuto는 항상 false입니다.