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 표현 
{
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "labelId": string,
  "removeLabel": boolean,
  "kind": string
}
필드
fieldModifications[]

object (FieldModification)

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

string

수정할 라벨의 ID입니다.
removeLabel

boolean

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

string

항상 "drive#labelModification"입니다.

FieldModification

라벨 필드의 수정사항입니다.

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

string

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

string

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

string

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

string (int64 format)

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

string

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

string

수정할 필드의 ID입니다.
kind

string

항상 "drive#labelFieldModification"입니다.
unsetValues

boolean

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