Method: files.modifyLabels

파일에 적용된 라벨 집합을 수정합니다. 추가되거나 수정된 라벨 목록을 반환합니다.

HTTP 요청

POST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels

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

경로 매개변수

매개변수
fileId

string

라벨이 속한 파일의 ID입니다.

요청 본문

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

응답 본문

files.modifyLabels 요청에 대한 응답입니다. 여기에는 요청에 의해 추가되거나 업데이트된 라벨만 포함됩니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
필드
modifiedLabels[]

object (Label)

요청에 의해 추가되거나 업데이트된 라벨 목록입니다.

kind

string

항상 drive#modifyLabelsResponse입니다.

승인 범위

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

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

ModifyLabelsRequest

파일의 라벨 세트를 수정하기 위한 요청입니다. 이 요청에는 모두 성공하거나 개별적으로 실패하게 되는 많은 수정사항이 포함될 수 있습니다.

JSON 표현
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
필드
labelModifications[]

object (LabelModification)

파일의 라벨에 적용할 수정사항 목록입니다.

kind

string

항상 drive#modifyLabelsRequest입니다.

LabelModification

파일의 라벨 수정입니다. LabelModification은 파일에 라벨을 적용하거나, 파일의 기존 라벨을 업데이트하거나, 파일에서 라벨을 삭제하는 데 사용할 수 있습니다.

JSON 표현
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
필드
labelId

string

수정할 라벨의 ID입니다.

fieldModifications[]

object (FieldModification)

이 라벨의 필드에 대한 수정 목록입니다.

removeLabel

boolean

true인 경우 파일에서 라벨이 삭제됩니다.

kind

string

항상 drive#labelModification입니다.

FieldModification

라벨 필드 수정입니다.

JSON 표현
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
필드
fieldId

string

수정할 필드의 ID입니다.

kind

string

항상 drive#labelFieldModification입니다.

setDateValues[]

string

date 필드의 값을 이러한 새 값으로 바꿉니다. 문자열은 RFC 3339 전체 날짜 형식(YYYY-MM-DD)이어야 합니다.

setTextValues[]

string

text 필드의 값을 설정합니다.

setSelectionValues[]

string

selection 필드를 이러한 새 값으로 바꿉니다.

setIntegerValues[]

string (int64 format)

integer 필드의 값을 이러한 새 값으로 바꿉니다.

setUserValues[]

string

user 필드를 이러한 새 값으로 바꿉니다. 값은 유효한 이메일 주소여야 합니다.

unsetValues

boolean

이 필드의 값을 설정 해제합니다.