Google Drive API는 파일 버전을 다운로드하고 게시할 수 있도록 버전 리소스를 제공합니다. 버전 용어에 대한 자세한 내용은 변경사항 및 버전 개요를 참고하세요.
자동 삭제로부터 저장할 버전 지정
Google Drive는 사용자가 더 이상 관심이 없는 이전 버전을 자동으로 삭제합니다. 이를 방지하려면 불리언 플래그 keepRevisionForever
를 true
로 설정하여 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
입니다.