Google Drive API는 다음 표에 나열된 여러 유형의 다운로드 및 내보내기 작업을 지원합니다.
다운로드 |
|
|||
내보내기 |
|
파일 콘텐츠를 다운로드하거나 내보내기 전에 사용자가 files
리소스의 capabilities.canDownload
필드를 사용하여 파일을 다운로드할 수 있는지 확인합니다.
이 가이드의 나머지 부분에서는 이러한 유형의 다운로드 및 내보내기 작업을 실행하는 방법을 자세히 안내합니다.
blob 파일 콘텐츠 다운로드
Drive에 저장된 blob 파일을 다운로드하려면 다운로드할 파일의 ID와 alt=media
URL 매개변수가 포함된 files.get
메서드를 사용합니다. alt=media
URL 매개변수는 대체 응답 형식으로 콘텐츠 다운로드가 요청되고 있음을 서버에 알립니다.
alt=media
URL 매개변수는 모든 Google REST API에서 사용할 수 있는 시스템 매개변수입니다. Drive API에 클라이언트 라이브러리를 사용하는 경우 이 매개변수를 명시적으로 설정할 필요가 없습니다.
다음 코드 샘플은 files.get
메서드를 사용하여 Drive API 클라이언트 라이브러리가 포함된 파일을 다운로드하는 방법을 보여줍니다.
Java
Python
Node.js
2,399필리핀
.NET
이 코드 샘플은 alt=media
URL 매개변수를 기본 HTTP 요청에 추가하는 라이브러리 메서드를 사용합니다.
앱에서 시작된 파일 다운로드는 파일 콘텐츠에 대한 읽기 액세스를 허용하는 범위로 승인되어야 합니다. 예를 들어 drive.readonly.metadata
범위를 사용하는 앱은 파일 콘텐츠를 다운로드할 권한이 없습니다.
이 코드 샘플은 사용자가 모든 Drive 파일을 보고 관리할 수 있도록 제한된 'drive' 파일 범위를 사용합니다. 드라이브 범위에 대한 자세한 내용은 Google Drive API 범위 선택을 참고하세요.
수정 권한이 있는 사용자는 copyRequiresWriterPermission
필드를 false
로 설정하여 읽기 전용 사용자의 다운로드를 제한할 수 있습니다.
악성으로 식별된 파일(예: 유해한 소프트웨어)은 파일 소유자만 다운로드할 수 있습니다.
또한 사용자가 원치 않을 가능성이 있는 소프트웨어나 기타 악성 파일을 다운로드할 위험을 인지했음을 나타내려면 get
쿼리 매개변수 acknowledgeAbuse=true
를 포함해야 합니다. 이 쿼리 매개변수를 사용하기 전에 애플리케이션에서 대화형으로 경고해야 합니다.
부분 다운로드
부분 다운로드는 파일의 지정된 부분만 다운로드하면 됩니다. Range
헤더와 함께 바이트 범위를 사용하여 다운로드할 파일 부분을 지정할 수 있습니다. 예를 들면 다음과 같습니다.
Range: bytes=500-999
이전 버전에서 blob 파일 콘텐츠 다운로드
이전 버전에서 blob 파일의 콘텐츠를 다운로드하려면 다운로드할 파일의 ID, 버전의 ID, alt=media
URL 매개변수와 함께 revisions.get
메서드를 사용합니다.
alt=media
URL 매개변수는 콘텐츠 다운로드가 대체 응답 형식으로 요청되고 있음을 서버에 알립니다. files.get
와 마찬가지로 revisions.get
메서드는 선택적 쿼리 매개변수인 acknowledgeAbuse
및 Range
헤더도 허용합니다. 버전 다운로드에 관한 자세한 내용은 파일 버전 다운로드 및 게시를 참고하세요.
브라우저에서 blob 파일 콘텐츠 다운로드
API를 사용하는 대신 브라우저 내에서 드라이브에 저장된 blob 파일의 콘텐츠를 다운로드하려면 files
리소스의 webContentLink
필드를 사용합니다. 사용자에게 파일 다운로드 액세스 권한이 있으면 파일 및 파일 콘텐츠를 다운로드할 수 있는 링크가 반환됩니다. 사용자를 이 URL로 리디렉션하거나 클릭 가능한 링크로 제공할 수 있습니다.
Google Workspace 문서 콘텐츠 내보내기
Google Workspace 문서 바이트 콘텐츠를 내보내려면 내보낼 파일의 ID와 올바른 MIME 유형이 포함된 files.export
메서드를 사용합니다. 내보내는 콘텐츠는 10MB로 제한됩니다.
다음 코드 샘플은 files.export
메서드를 사용하여 Drive API 클라이언트 라이브러리를 사용하여 Google Workspace 문서를 PDF 형식으로 내보내는 방법을 보여줍니다.
Java
Python
Node.js
2,399필리핀
.NET
이 코드 샘플은 사용자가 모든 Drive 파일을 보고 관리할 수 있도록 제한된 drive
범위를 사용합니다. 드라이브 범위에 대한 자세한 내용은 Google Drive API 범위 선택을 참고하세요.
또한 이 코드 샘플은 내보내기 MIME 유형을 application/pdf
로 선언합니다. 각 Google Workspace 문서에 지원되는 모든 내보내기 MIME 유형의 전체 목록은 Google Workspace 문서의 MIME 유형 내보내기를 참고하세요.
브라우저에서 Google Workspace 문서 콘텐츠 내보내기
브라우저 내에서 Google Workspace 문서 콘텐츠를 내보내려면 files
리소스의 exportLinks
필드를 사용합니다. 문서 유형에 따라, 사용 가능한 모든 MIME 유형에 대해 파일 및 콘텐츠를 다운로드할 수 있는 링크가 반환됩니다. 사용자를 URL로 리디렉션하거나 클릭 가능한 링크로 제공할 수 있습니다.
브라우저에서 이전 버전의 Google Workspace 문서 콘텐츠 내보내기
브라우저 내 이전 버전의 Google Workspace 문서 콘텐츠를 내보내려면 다운로드할 파일의 ID와 버전 ID와 함께 revisions.get
메서드를 사용합니다. 사용자에게 파일 다운로드 액세스 권한이 있으면 파일 및 파일 콘텐츠를 다운로드할 수 있는 링크가 반환됩니다. 사용자를 이 URL로 리디렉션하거나 클릭 가능한 링크로 제공할 수 있습니다.