새 파일을 만듭니다.
이 메서드는 /upload URI를 지원하며 다음과 같은 특성을 가진 업로드된 미디어를 허용합니다.
- 최대 파일 크기: 5,120GB
- 허용되는 미디어 MIME 유형:
*/*
참고: 리터럴 */* 값이 아닌 유효한 MIME 유형을 지정하세요. 리터럴 */*는 유효한 MIME 유형을 업로드할 수 있음을 나타내는 데만 사용됩니다.
파일 업로드에 대한 자세한 내용은 파일 데이터 업로드를 참조하세요.
files.create로 바로가기를 만드는 앱은 MIME 유형 application/vnd.google-apps.shortcut을 지정해야 합니다.
앱은 API로 파일을 삽입할 때 name 속성에서 파일 확장자를 지정해야 합니다. 예를 들어 JPEG 파일을 삽입하는 작업은 메타데이터에 "name": "cat.jpg"와 같은 내용을 지정해야 합니다.
후속 GET 요청에는 title 속성에 원래 지정된 확장 프로그램으로 채워진 읽기 전용 fileExtension 속성이 포함됩니다. Google Drive 사용자가 파일 다운로드를 요청하거나 동기화 클라이언트를 통해 파일이 다운로드되면 Drive에서는 제목을 기준으로 전체 파일 이름 (확장자 포함)을 만듭니다. 확장자가 누락된 경우 Drive에서 파일의 MIME 유형에 따라 확장자를 확인하려고 시도합니다.
HTTP 요청
- 미디어 업로드 요청의 업로드 URI:
POST https://www.googleapis.com/upload/drive/v3/files - 메타데이터 전용 요청용 메타데이터 URI:
POST https://www.googleapis.com/drive/v3/files
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
| 매개변수 | |
|---|---|
uploadType |
사용 가능한 값:
|
enforceSingleParent |
지원이 중단되었습니다. 여러 폴더에 파일을 만드는 기능은 더 이상 지원되지 않습니다. |
ignoreDefaultVisibility |
생성된 파일에 대한 도메인의 기본 공개 상태 설정을 무시할지 여부입니다. 도메인 관리자는 기본적으로 업로드된 모든 파일을 도메인에 표시하도록 선택할 수 있습니다. 이 매개변수는 요청에 대해 이러한 동작을 우회합니다. 권한은 계속해서 상위 폴더에서 상속됩니다. |
keepRevisionForever |
새 제목 버전의 'keepForever' 필드 설정 여부입니다. 이는 Google Drive에 바이너리 콘텐츠가 있는 파일에만 적용됩니다. 파일의 버전은 200개만 영구 보관할 수 있습니다. 한도에 도달하면 고정된 버전을 삭제해 보세요. |
ocrLanguage |
이미지를 가져오는 동안 OCR 처리를 위한 언어 힌트입니다 (ISO 639-1 코드). |
supportsAllDrives |
요청하는 애플리케이션에서 내 드라이브와 공유 드라이브를 모두 지원하는지 여부 |
supportsTeamDrives |
지원 중단됨: 대신 |
useContentAsIndexableText |
업로드된 콘텐츠를 색인 생성이 가능한 텍스트로 사용할지 여부입니다. |
includePermissionsForView |
응답에 포함할 추가 뷰의 권한을 지정합니다. '게시됨'만 지원됩니다. |
includeLabels |
응답의 |
요청 본문
요청 본문에는 File의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 File의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.file
일부 범위가 제한되며 앱에서 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.