Method: labels.delta

일련의 업데이트 요청을 적용하여 단일 라벨을 업데이트하여 새 초안 버전을 만듭니다. 일괄 업데이트는 '전부 또는 전혀'입니다. 업데이트 요청 중 하나라도 잘못된 경우 변경사항이 적용되지 않습니다. 변경사항을 Drive 항목에 적용하려면 결과 초안 수정사항을 게시해야 합니다.

HTTP 요청

POST https://drivelabels.googleapis.com/v2beta/{name=labels/*}:delta

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 업데이트할 라벨의 리소스 이름입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "writeControl": {
    object (WriteControl)
  },
  "requests": [
    {
      object (Request)
    }
  ],
  "useAdminAccess": boolean,
  "view": enum (LabelView),
  "languageCode": string
}
필드
writeControl

object (WriteControl)

쓰기 요청이 실행되는 방식을 제어합니다.
requests[]

object (Request)

라벨에 적용할 업데이트 목록입니다. 요청은 지정된 순서대로 적용됩니다.
useAdminAccess

boolean

사용자의 관리자 사용자 인증 정보를 사용하려면 true로 설정합니다. 서버는 사용자가 라벨의 관리자인지 확인한 후 액세스를 허용합니다.
view

enum (LabelView)

지정하면 표시된 뷰에 속한 특정 필드만 반환됩니다.
languageCode

string

include_label_in_response이 true인 경우 현지화된 필드 라벨을 평가하는 데 사용할 BCP-47 언어 코드입니다.

응답 본문

라벨 업데이트의 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "responses": [
    {
      object (Response)
    }
  ],
  "updatedLabel": {
    object (Label)
  }
}
필드
responses[]

object (Response)

업데이트의 답장입니다. 일부 요청에 대한 응답은 비어 있을 수 있지만 업데이트와 1:1로 매핑됩니다.
updatedLabel

object (Label)

업데이트가 적용된 후의 라벨입니다. [BatchUpdateLabelResponse2.include_label_in_response] 가 true이고 오류가 없는 경우에만 설정됩니다.

승인 범위

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

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

자세한 내용은 승인 가이드를 참고하세요.

요청

라벨에 적용할 단일 업데이트 유형입니다.

JSON 표현 
{

  // Union field kind can be only one of the following:
  "updateLabel": {
    object (UpdateLabelPropertiesRequest)
  },
  "createField": {
    object (CreateFieldRequest)
  },
  "updateField": {
    object (UpdateFieldPropertiesRequest)
  },
  "updateFieldType": {
    object (UpdateFieldTypeRequest)
  },
  "enableField": {
    object (EnableFieldRequest)
  },
  "disableField": {
    object (DisableFieldRequest)
  },
  "deleteField": {
    object (DeleteFieldRequest)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceRequest)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesRequest)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceRequest)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceRequest)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceRequest)
  }
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 업데이트 유형입니다. 필드는 정확히 하나만 필요합니다. kind은 다음 중 하나여야 합니다.
updateLabel

object (UpdateLabelPropertiesRequest)

라벨 속성을 업데이트합니다.
createField

object (CreateFieldRequest)

새 필드를 만듭니다.
updateField

object (UpdateFieldPropertiesRequest)

필드의 기본 속성을 업데이트합니다.
updateFieldType

object (UpdateFieldTypeRequest)

필드 유형 또는 유형 옵션을 업데이트합니다.
enableField

object (EnableFieldRequest)

필드를 사용 설정합니다.
disableField

object (DisableFieldRequest)

필드를 사용 중지합니다.
deleteField

object (DeleteFieldRequest)

라벨에서 필드를 삭제합니다.
createSelectionChoice

object (CreateSelectionChoiceRequest)

선택 필드 내에 선택 항목을 만듭니다.
updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesRequest)

선택 필드 내에서 선택 속성을 업데이트합니다.
enableSelectionChoice

object (EnableSelectionChoiceRequest)

선택 입력란 내에 선택을 사용 설정합니다.
disableSelectionChoice

object (DisableSelectionChoiceRequest)

선택 필드 내에서 선택을 사용 중지합니다.
deleteSelectionChoice

object (DeleteSelectionChoiceRequest)

선택 필드 내에서 선택사항을 삭제합니다.

UpdateLabelPropertiesRequest

라벨의 기본 속성을 업데이트합니다.

JSON 표현 
{
  "updateMask": string,
  "properties": {
    object (Properties)
  }
}
필드
updateMask

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 label_properties는 암시되며 지정해서는 안 됩니다. 단일 *는 모든 필드를 업데이트하는 방법으로 사용할 수 있습니다.
properties

object (Properties)

필수 항목입니다. 업데이트할 라벨 속성입니다.

CreateFieldRequest

라벨 내에 필드를 만들기 위한 요청입니다.

JSON 표현 
{
  "field": {
    object (Field)
  }
}
필드
field

object (Field)

필수 항목입니다. 만들 필드입니다.

UpdateFieldPropertiesRequest

필드 속성 업데이트 요청입니다.

JSON 표현 
{
  "updateMask": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
필드
updateMask

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 properties는 암시되며 지정해서는 안 됩니다. 단일 *는 모든 필드를 업데이트하는 방법으로 사용할 수 있습니다.
id

string

필수 항목입니다. 업데이트할 필드입니다.
properties

object (Properties)

필수 항목입니다. 기본 필드 속성

UpdateFieldTypeRequest

필드 유형 변경 요청입니다.

JSON 표현 
{
  "updateMask": string,
  "id": string,

  // Union field type_options can be only one of the following:
  "textOptions": {
    object (TextOptions)
  },
  "integerOptions": {
    object (IntegerOptions)
  },
  "dateOptions": {
    object (DateOptions)
  },
  "selectionOptions": {
    object (SelectionOptions)
  },
  "userOptions": {
    object (UserOptions)
  }
  // End of list of possible types for union field type_options.
}
필드
updateMask

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. type_options의 루트는 암시되며 지정해서는 안 됩니다. 단일 *는 모든 필드를 업데이트하는 방법으로 사용할 수 있습니다.
id

string

필수 항목입니다. 업데이트할 필드입니다.

통합 필드 type_options.

type_options는 다음 중 하나여야 합니다.
textOptions

object (TextOptions)

필드를 텍스트로 업데이트합니다.
integerOptions

object (IntegerOptions)

필드를 정수로 업데이트합니다.
dateOptions

object (DateOptions)

필드를 날짜로 업데이트합니다.
selectionOptions

object (SelectionOptions)

필드를 선택으로 업데이트합니다.
userOptions

object (UserOptions)

필드를 사용자로 업데이트합니다.

EnableFieldRequest

필드 사용 설정 요청

JSON 표현 
{
  "id": string
}
필드
id

string

필수 항목입니다. 사용 설정할 필드의 ID입니다.

DisableFieldRequest

필드 사용 중지 요청입니다.

JSON 표현 
{
  "updateMask": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
필드
updateMask

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 disabledPolicy는 암시되며 지정해서는 안 됩니다. 단일 *는 모든 필드를 업데이트하는 방법으로 사용할 수 있습니다.
id

string

필수 항목입니다. 사용 중지할 필드의 키입니다.
disabledPolicy

object (DisabledPolicy)

필수 항목입니다. 입력란 사용 중지 정책

DeleteFieldRequest

필드 삭제 요청입니다.

JSON 표현 
{
  "id": string
}
필드
id

string

필수 항목입니다. 삭제할 필드의 ID입니다.

CreateSelectionChoiceRequest

선택 항목 만들기 요청입니다.

JSON 표현 
{
  "fieldId": string,
  "choice": {
    object (Choice)
  }
}
필드
fieldId

string

필수 항목입니다. 선택 항목이 생성될 선택 필드입니다.
choice

object (Choice)

필수 항목입니다. 만들기 선택

UpdateSelectionChoicePropertiesRequest

선택 속성 업데이트 요청입니다.

JSON 표현 
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
필드
updateMask

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 properties는 암시되며 지정해서는 안 됩니다. 단일 *는 모든 필드를 업데이트하는 방법으로 사용할 수 있습니다.
fieldId

string

필수 항목입니다. 업데이트할 선택 필드입니다.
id

string

필수 항목입니다. 업데이트할 선택사항입니다.
properties

object (Properties)

필수 항목입니다. 업데이트할 Choice 속성입니다.

EnableSelectionChoiceRequest

선택을 사용 설정하도록 요청합니다.

JSON 표현 
{
  "fieldId": string,
  "id": string
}
필드
fieldId

string

필수 항목입니다. 선택이 사용 설정되는 선택 필드입니다.
id

string

필수 항목입니다. 사용 설정 여부 선택

DisableSelectionChoiceRequest

선택사항 사용 중지 요청입니다.

JSON 표현 
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
필드
updateMask

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 disabledPolicy는 암시되며 지정해서는 안 됩니다. 단일 *는 모든 필드를 업데이트하는 방법으로 사용할 수 있습니다.
fieldId

string

필수 항목입니다. 선택사항이 사용 중지되는 선택 필드입니다.
id

string

필수 항목입니다. 사용 중지 옵션
disabledPolicy

object (DisabledPolicy)

필수 항목입니다. 업데이트할 사용 중지된 정책입니다.

DeleteSelectionChoiceRequest

선택사항 삭제 요청입니다.

JSON 표현 
{
  "fieldId": string,
  "id": string
}
필드
fieldId

string

필수 항목입니다. 선택 항목이 삭제될 선택 필드입니다.
id

string

필수 항목입니다. 삭제 옵션

응답

업데이트의 단일 응답입니다.

JSON 표현 
{

  // Union field response can be only one of the following:
  "updateLabel": {
    object (UpdateLabelPropertiesResponse)
  },
  "createField": {
    object (CreateFieldResponse)
  },
  "updateField": {
    object (UpdateFieldPropertiesResponse)
  },
  "updateFieldType": {
    object (UpdateFieldTypeResponse)
  },
  "enableField": {
    object (EnableFieldResponse)
  },
  "disableField": {
    object (DisableFieldResponse)
  },
  "deleteField": {
    object (DeleteFieldResponse)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceResponse)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesResponse)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceResponse)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceResponse)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceResponse)
  }
  // End of list of possible types for union field response.
}
필드
통합 필드 response. 해당 요청에 대한 응답입니다. response은 다음 중 하나여야 합니다.
updateLabel

object (UpdateLabelPropertiesResponse)

라벨의 기본 속성을 업데이트했습니다.
createField

object (CreateFieldResponse)

새 필드를 만듭니다.
updateField

object (UpdateFieldPropertiesResponse)

필드의 기본 속성을 업데이트합니다.
updateFieldType

object (UpdateFieldTypeResponse)

필드 유형 또는 유형 옵션을 업데이트합니다.
enableField

object (EnableFieldResponse)

필드를 사용 설정합니다.
disableField

object (DisableFieldResponse)

필드를 사용 중지합니다.
deleteField

object (DeleteFieldResponse)

라벨에서 필드를 삭제합니다.
createSelectionChoice

object (CreateSelectionChoiceResponse)

선택 필드에 추가할 새 선택 목록 옵션을 만듭니다.
updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesResponse)

선택 필드 내에서 선택사항을 업데이트합니다.
enableSelectionChoice

object (EnableSelectionChoiceResponse)

선택 필드 내에서 선택을 사용 설정합니다.
disableSelectionChoice

object (DisableSelectionChoiceResponse)

선택 필드 내에서 선택을 사용 중지합니다.
deleteSelectionChoice

object (DeleteSelectionChoiceResponse)

선택 필드에서 선택사항을 삭제합니다.

UpdateLabelPropertiesResponse

이 유형에는 필드가 없습니다.

라벨 속성을 업데이트한 후의 응답

CreateFieldResponse

필드 생성에 따른 응답

JSON 표현 
{
  "id": string,
  "priority": integer
}
필드
id

string

생성된 필드의 필드입니다. 생성 요청에서 이 입력란을 비워 두면 키가 자동 생성되며 여기에서 확인할 수 있습니다.
priority

integer

생성된 필드의 우선순위입니다. 필드 간에 연속된 우선순위를 보장하기 위해 지정된 우선순위가 변경될 수 있습니다 (1~n).

UpdateFieldPropertiesResponse

필드 속성 업데이트 후 응답

JSON 표현 
{
  "priority": integer
}
필드
priority

integer

업데이트된 필드의 우선순위입니다. 필드 간에 연속된 우선순위를 보장하기 위해 지정된 우선순위가 변경될 수 있습니다 (1~n).

UpdateFieldTypeResponse

이 유형에는 필드가 없습니다.

필드 유형 업데이트 후 응답

EnableFieldResponse

이 유형에는 필드가 없습니다.

필드 사용 설정 후 응답

DisableFieldResponse

이 유형에는 필드가 없습니다.

필드 사용 중지 후 응답

DeleteFieldResponse

이 유형에는 필드가 없습니다.

필드 삭제 후 응답

CreateSelectionChoiceResponse

선택 항목 생성에 따른 응답

JSON 표현 
{
  "fieldId": string,
  "id": string
}
필드
fieldId

string

서버에서 생성된 필드의 ID입니다.
id

string

필드 내에서 생성된 선택의 서버 생성 ID입니다.

UpdateSelectionChoicePropertiesResponse

선택 항목 속성을 업데이트한 후의 응답입니다.

JSON 표현 
{
  "priority": integer
}
필드
priority

integer

업데이트된 선택의 우선순위입니다. 선택사항 (1~n) 간에 연속된 우선순위를 보장하기 위해 지정된 우선순위가 변경될 수 있습니다.

EnableSelectionChoiceResponse

이 유형에는 필드가 없습니다.

선택 사용 설정 후 응답

DisableSelectionChoiceResponse

이 유형에는 필드가 없습니다.

선택 사용 중지에 따른 응답

DeleteSelectionChoiceResponse

이 유형에는 필드가 없습니다.

선택 삭제 후 응답