파일의 메타데이터 또는 콘텐츠를 업데이트합니다. 이 메서드를 호출할 때 수정하려는 요청의 필드만 채웁니다. 필드를 업데이트할 때 modifiedDate
와 같은 일부 필드는 자동으로 변경될 수 있습니다. 이 메서드는 패치 시맨틱스를 지원합니다.
이 메서드는 /upload URI를 지원하며 다음과 같은 특성을 가진 업로드된 미디어를 허용합니다.
- 최대 파일 크기: 5,120GB
- 허용되는 미디어 MIME 유형:
*/*
참고: 리터럴 */*
값이 아닌 유효한 MIME 유형을 지정하세요. 리터럴 */*
는 유효한 MIME 유형을 업로드할 수 있음을 나타내는 데만 사용됩니다.
파일 업로드에 대한 자세한 내용은 파일 데이터 업로드를 참조하세요.
HTTP 요청
- 미디어 업로드 요청의 업로드 URI:
PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
- 메타데이터 전용 요청용 메타데이터 URI:
PATCH https://www.googleapis.com/drive/v3/files/{fileId}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
uploadType |
사용 가능한 값:
|
fileId |
파일의 ID입니다. |
쿼리 매개변수
매개변수 | |
---|---|
uploadType |
사용 가능한 값:
|
addParents |
추가할 상위 ID를 쉼표로 구분된 목록으로 보여줍니다. |
enforceSingleParent |
지원 중단됨: 파일을 여러 폴더에 추가하는 기능은 더 이상 지원되지 않습니다. 대신 단축키를 사용하세요. |
keepRevisionForever |
새 제목 버전의 'keepForever' 필드 설정 여부입니다. 이는 Google Drive에 바이너리 콘텐츠가 있는 파일에만 적용됩니다. 파일의 버전은 200개만 영구 보관할 수 있습니다. 한도에 도달하면 고정된 버전을 삭제해 보세요. |
ocrLanguage |
이미지를 가져오는 동안 OCR 처리를 위한 언어 힌트입니다 (ISO 639-1 코드). |
removeParents |
삭제할 상위 ID를 쉼표로 구분한 목록입니다. |
supportsAllDrives |
요청하는 애플리케이션에서 내 드라이브와 공유 드라이브를 모두 지원하는지 여부 |
supportsTeamDrives |
지원 중단됨: 대신 |
useContentAsIndexableText |
업로드된 콘텐츠를 색인 생성이 가능한 텍스트로 사용할지 여부입니다. |
includePermissionsForView |
응답에 포함할 추가 뷰의 권한을 지정합니다. '게시됨'만 지원됩니다. |
includeLabels |
응답의 |
요청 본문
요청 본문에는 File
의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 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.scripts
일부 범위가 제한되며 앱에서 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.