Method: files.download

파일의 콘텐츠를 다운로드합니다. 작업은 생성 시점부터 24시간 동안 유효합니다.

HTTP 요청

POST https://www.googleapis.com/drive/v3/files/{fileId}/download

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
fileId

string

필수 항목입니다. 다운로드할 파일의 ID입니다.

쿼리 매개변수

매개변수
mimeType

string

선택사항입니다. 파일을 다운로드할 MIME 유형입니다. 이 필드는 Google Workspace 문서를 다운로드할 때만 설정할 수 있습니다. 지원되는 MIME 유형 목록은 Google Workspace 문서의 files.export MIME 유형을 참고하세요. 이 값을 설정하지 않으면 Google Workspace 문서가 기본 MIME 유형으로 다운로드됩니다. 기본 MIME 유형은 향후 변경될 수 있습니다.

revisionId

string

선택사항입니다. 다운로드할 파일의 버전 ID입니다. 이 필드는 blob 파일, Google Docs, Google Sheets를 다운로드할 때만 설정할 수 있습니다. 파일의 특정 버전 다운로드가 지원되지 않는 경우 INVALID_ARGUMENT를 반환합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly

일부 범위는 제한되어 있으며 앱에서 이를 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.