Method: files.update

파일의 메타데이터, 콘텐츠 또는 둘 다를 업데이트합니다.

이 메서드를 호출할 때는 수정하려는 요청의 필드만 채우세요. 필드를 업데이트할 때 modifiedDate와 같은 일부 필드가 자동으로 변경될 수 있습니다. 이 메소드는 패치 의미 체계를 지원합니다.

이 메서드는 /upload URI를 지원하며 다음과 같은 특징이 있는 업로드된 미디어를 허용합니다.

  • 최대 파일 크기: 5,120GB
  • 허용되는 미디어 MIME 유형: */*

    (리터럴 */* 값 대신 유효한 MIME 유형을 지정하세요. 리터럴 */*는 유효한 MIME 유형을 업로드할 수 있음을 나타내는 데만 사용됩니다. 자세한 내용은 Google Workspace 및 Google Drive에서 지원되는 MIME 유형을 참고하세요.)

파일 업로드에 대한 자세한 내용은 파일 데이터 업로드를 참고하세요.

HTTP 요청

  • 업로드 URI, 미디어 업로드 요청:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • 메타데이터 URI, 메타데이터 전용 요청:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
fileId

string

업데이트할 파일의 ID입니다.

쿼리 매개변수

매개변수
addParents

string

추가할 상위 ID의 쉼표로 구분된 목록입니다.
convert
(deprecated)

boolean

지원 중단됨: 이 매개변수는 기능이 없습니다.
enforceSingleParent
(deprecated)

boolean

지원 중단됨: 여러 폴더에 파일을 추가하는 기능이 더 이상 지원되지 않습니다. 대신 shortcuts를 사용하세요.
modifiedDateBehavior

enum (ModifiedDateBehavior)

modifiedDate가 업데이트되는 동작을 결정합니다. 이렇게 하면 setModifiedDate이 재정의됩니다.
newRevision

boolean

블롭 업로드가 새 버전을 만들어야 하는지 여부입니다. false인 경우 현재 헤드 수정사항의 blob 데이터가 대체됩니다. true이거나 설정되지 않은 경우 새 blob이 헤드 버전으로 생성되고 고정되지 않은 이전 버전은 잠시 동안 보존됩니다. 고정된 버전은 최대 200개까지 추가 스토리지 할당량을 사용하여 무기한 저장됩니다. 버전이 보관되는 방식에 대한 자세한 내용은 Drive 고객센터를 참고하세요.
ocr

boolean

.jpg, .png, .gif 또는 .pdf 업로드에 OCR을 시도할지 여부입니다.
ocrLanguage

string

ocr이 true인 경우 사용할 언어를 힌트로 제공합니다. 유효한 값은 BCP 47 코드입니다.
pinned

boolean

새 버전을 고정할지 여부입니다. 파일에는 최대 200개의 고정된 버전이 있을 수 있습니다.
removeParents

string

삭제할 상위 ID의 쉼표로 구분된 목록입니다.
setModifiedDate

boolean

요청 본문에 제공된 값을 사용하여 수정된 날짜를 설정할지 여부입니다. 이 필드를 true로 설정하는 것은 modifiedDateBehavior=fromBodyOrNow와 동일하며 false는 modifiedDateBehavior=now와 동일합니다. 수정된 날짜가 변경되지 않도록 하려면 modifiedDateBehavior=noChange를 설정하세요.
supportsAllDrives

boolean

요청하는 애플리케이션이 내 드라이브와 공유 드라이브를 모두 지원하는지 여부입니다.
supportsTeamDrives
(deprecated)

boolean

지원 중단됨: 대신 supportsAllDrives을 사용하세요.
timedTextLanguage

string

시간 제한 텍스트의 언어입니다.
timedTextTrackName

string

시간 제한 텍스트 트랙 이름입니다.
updateViewedDate

boolean

파일 업데이트가 완료된 후 조회 날짜를 업데이트할지 여부입니다.
uploadType

string

/upload URI에 대한 업로드 요청 유형입니다. /upload URI를 사용하여 데이터를 업로드하는 경우 이 필드는 필수입니다. 메타데이터 전용 파일을 만드는 경우 이 필드는 필요하지 않습니다. 또한 위젯은 데이터 업로드를 지원하지 않으므로 이 필드는 '이 메서드 사용해 보기' 위젯에 표시되지 않습니다.

사용 가능한 값:

  • media - 간단한 업로드. 메타데이터 없이 미디어만 업로드합니다.
  • multipart - 멀티파트 업로드. 단일 요청으로 미디어와 메타데이터를 모두 업로드합니다.
  • resumable - 재개 가능한 업로드. 첫 번째 요청에 메타데이터가 포함된 2개 이상의 요청을 사용하여 재개 가능한 방식으로 파일을 업로드합니다.
useContentAsIndexableText

boolean

콘텐츠를 색인 생성 가능한 텍스트로 사용할지 여부입니다.
includePermissionsForView

string

응답에 포함할 추가 뷰의 권한을 지정합니다. published만 지원됩니다.
includeLabels

string

응답의 labelInfo 부분에 포함할 라벨 ID의 쉼표로 구분된 목록입니다.

요청 본문

요청 본문에 File의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 File의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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