Method: files.get

ID별로 파일의 메타데이터 또는 콘텐츠를 가져옵니다.

URL 매개변수 alt=media를 제공하면 응답 본문에 파일 콘텐츠가 포함됩니다. alt=media을(를) 사용하여 콘텐츠를 다운로드하는 기능은 파일이 Drive에 저장되어 있는 경우에만 작동합니다. Google Docs, Sheets, Slides를 다운로드하려면 대신 files.export를 사용하세요. 자세한 내용은 파일 다운로드 및 내보내기를 참고하세요.

HTTP 요청

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

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

경로 매개변수

매개변수
fileId

string

파일의 ID입니다.

쿼리 매개변수

매개변수
acknowledgeAbuse

boolean

사용자가 알려진 멀웨어 또는 기타 악성 파일을 다운로드할 위험을 인정하는지 여부 Alt=media인 경우에만 적용됩니다.

supportsAllDrives

boolean

요청하는 애플리케이션에서 내 드라이브와 공유 드라이브를 모두 지원하는지 여부

supportsTeamDrives
(deprecated)

boolean

지원 중단됨: 대신 supportsAllDrives를 사용하세요.

includePermissionsForView

string

응답에 포함할 추가 뷰의 권한을 지정합니다. '게시됨'만 지원됩니다.

includeLabels

string

응답의 labelInfo 부분에 포함할 쉼표로 구분된 라벨 ID 목록입니다.

요청 본문

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

응답 본문

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

승인 범위

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

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

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