파일의 메타데이터 또는 콘텐츠를 업데이트합니다. 이 메서드를 호출할 때 수정하려는 요청의 필드만 채웁니다. 필드를 업데이트할 때 editDate와 같은 일부 필드가 자동으로 변경될 수 있습니다. 이 메서드는 패치 시맨틱스를 지원합니다.
HTTP 요청
PATCH https://www.googleapis.com/drive/v2/files/{fileId}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
fileId |
업데이트할 파일의 ID입니다. |
쿼리 매개변수
| 매개변수 | |
|---|---|
addParents |
추가할 상위 ID를 쉼표로 구분된 목록으로 보여줍니다. |
convert |
지원 중단됨: 이 매개변수에는 함수가 없습니다. |
enforceSingleParent |
지원 중단됨: 파일을 여러 폴더에 추가하는 기능은 더 이상 지원되지 않습니다. 대신 |
modifiedDateBehavior |
|
newRevision |
blob 업로드로 새 버전을 만들어야 하는지 여부입니다. false인 경우 현재 헤드 버전의 blob 데이터가 대체됩니다. true이거나 설정하지 않으면 새 blob이 헤드 버전으로 생성되고, 고정되지 않은 이전 버전은 짧은 기간 동안 보존됩니다. 고정된 버전은 최대 200개 버전까지 추가 스토리지 할당량을 사용하여 무기한 저장됩니다. 버전이 보관되는 방법에 대한 자세한 내용은 Drive 고객센터를 참고하세요. 요청에 페이로드가 없으면 이 필드는 무시됩니다. |
ocr |
.jpg, .png, .gif 또는 .pdf 업로드에 대한 OCR의 시도 여부입니다. |
ocrLanguage |
ocr이 true인 경우 사용할 언어를 알려줍니다. 유효한 값은 BCP 47 코드입니다. |
pinned |
새 버전의 고정 여부입니다. 파일에는 최대 200개의 고정된 버전이 포함될 수 있습니다. 요청에 페이로드가 없으면 이 필드는 무시됩니다. |
removeParents |
삭제할 상위 ID 목록(쉼표로 구분)입니다. |
setModifiedDate |
요청 본문에 제공된 값을 사용하여 수정된 날짜를 설정할지 여부입니다. 이 필드를 |
supportsAllDrives |
요청하는 애플리케이션에서 내 드라이브와 공유 드라이브를 모두 지원하는지 여부 |
supportsTeamDrives |
지원 중단됨: 대신 |
timedTextLanguage |
시간이 지정된 텍스트의 언어입니다. |
timedTextTrackName |
시간이 지정된 텍스트 트랙 이름입니다. |
updateViewedDate |
파일을 성공적으로 업데이트한 후 뷰 날짜를 업데이트할지 여부입니다. |
useContentAsIndexableText |
콘텐츠를 색인 생성이 가능한 텍스트로 사용할지 여부입니다. |
includePermissionsForView |
응답에 포함할 추가 뷰의 권한을 지정합니다. |
includeLabels |
응답의 |
요청 본문
요청 본문에는 File의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 File의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/docshttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.apps.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.scripts
일부 범위가 제한되며 앱에서 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.