ID별로 파일의 메타데이터 또는 콘텐츠를 가져옵니다. 지금 사용해 보기
URL 매개변수 alt=media를 제공하면 응답의 응답 본문에 파일 콘텐츠가 포함됩니다. alt=media를 사용하여 콘텐츠 다운로드는 파일이 Drive에 저장된 경우에만 작동합니다. Google Docs, Sheets, Slides를 다운로드하려면 files.export를 사용하세요. 파일 다운로드에 대한 자세한 내용은 파일 다운로드 및 내보내기를 참고하세요.
요청
HTTP 요청
GET https://www.googleapis.com/drive/v3/files/fileId
매개변수
| 매개변수 이름 | 값 | 설명 |
|---|---|---|
| 경로 매개변수 | ||
fileId |
string |
파일의 ID입니다. |
| 쿼리 매개변수(선택사항) | ||
acknowledgeAbuse |
boolean |
사용자가 알려진 멀웨어 또는 기타 악성 파일을 다운로드할 위험을 인지하고 있는지 여부 이는 alt=media인 경우에만 적용됩니다.
(기본값: false)
|
fields |
string |
응답에 포함할 필드의 경로입니다. 지정하지 않으면 응답에 이 메서드와 관련된 기본 필드 세트가 포함됩니다. 개발의 경우 특수 값 *을 사용하여 모든 필드를 반환할 수 있지만 필요한 필드만 선택하면 성능이 향상됩니다. 자세한 내용은 파일의 특정 필드 반환하기를 참고하세요.
|
includeLabels |
string |
응답의 labelInfo 부분에 포함할 라벨 ID를 쉼표로 구분한 목록입니다.
|
includePermissionsForView |
string |
응답에 포함할 추가 뷰의 권한을 지정합니다. '게시됨'만 지원됩니다. |
supportsAllDrives |
boolean |
요청하는 애플리케이션이 내 드라이브와 공유 드라이브를 모두 지원하는지 여부
(기본값: false)
|
supportsTeamDrives |
boolean |
지원 중단된 SupportAllDrives를 대신 사용하세요.
(기본값: false)
|
승인
이 요청은 다음 범위 중 하나 이상을 사용한 승인을 허용합니다.
| 범위 |
|---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
https://www.googleapis.com/auth/drive.readonly |
https://www.googleapis.com/auth/drive.metadata.readonly |
https://www.googleapis.com/auth/drive.appdata |
https://www.googleapis.com/auth/drive.metadata |
https://www.googleapis.com/auth/drive.photos.readonly |
일부 범위는 제한되어 있으며 앱에서 이를 사용하려면 보안 평가가 필요합니다. 자세한 내용은 인증 및 승인 페이지를 참고하세요.
요청 본문
이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.
응답
기본적으로 응답 본문에 Files 리소스로 응답합니다. URL 매개변수 alt=media를 제공하면 응답의 응답 본문에 파일 콘텐츠가 포함됩니다. alt=media를 사용하여 콘텐츠 다운로드는 파일이 Drive에 저장된 경우에만 작동합니다. Google Docs, Sheets, Slides를 다운로드하려면 files.export를 사용하세요. 파일 다운로드에 대한 자세한 내용은 파일 다운로드 및 내보내기를 참고하세요.
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.