Method: files.get

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

URL 매개변수 alt=media를 제공하면 응답의 응답 본문에 파일 콘텐츠가 포함됩니다. 파일이 Drive에 저장된 경우에만 alt=media를 사용하여 콘텐츠를 다운로드할 수 있습니다. 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.meet.readonly
  • 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

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