Method: files.update

파일의 메타데이터 또는 콘텐츠를 업데이트합니다. 이 메서드를 호출할 때 수정하려는 요청의 필드만 채웁니다. 필드를 업데이트할 때 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

string

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

사용 가능한 값:

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

string

파일의 ID입니다.

쿼리 매개변수

매개변수
uploadType

string

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

사용 가능한 값:

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

string

추가할 상위 ID를 쉼표로 구분된 목록으로 보여줍니다.

enforceSingleParent
(deprecated)

boolean

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

keepRevisionForever

boolean

새 제목 버전의 'keepForever' 필드 설정 여부입니다. 이는 Google Drive에 바이너리 콘텐츠가 있는 파일에만 적용됩니다. 파일의 버전은 200개만 영구 보관할 수 있습니다. 한도에 도달하면 고정된 버전을 삭제해 보세요.

ocrLanguage

string

이미지를 가져오는 동안 OCR 처리를 위한 언어 힌트입니다 (ISO 639-1 코드).

removeParents

string

삭제할 상위 ID를 쉼표로 구분한 목록입니다.

supportsAllDrives

boolean

요청하는 애플리케이션에서 내 드라이브와 공유 드라이브를 모두 지원하는지 여부

supportsTeamDrives
(deprecated)

boolean

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

useContentAsIndexableText

boolean

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

includePermissionsForView

string

응답에 포함할 추가 뷰의 권한을 지정합니다. '게시됨'만 지원됩니다.

includeLabels

string

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

요청 본문

요청 본문에는 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

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