REST Resource: labels

리소스: 라벨

라벨은 여러 항목을 정리하고 검색하기 위해 Drive 항목에 적용할 수 있는 분류를 정의합니다. 라벨은 간단한 문자열일 수도 있고 Drive 항목을 정리하고 검색하는 데 추가로 사용할 수 있는 추가 메타데이터를 설명하는 필드를 포함할 수도 있습니다.

JSON 표현
{
  "name": string,
  "id": string,
  "revisionId": string,
  "labelType": enum (LabelType),
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "revisionCreator": {
    object (UserInfo)
  },
  "revisionCreateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "customer": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedLabelPolicy": {
    object (AppliedLabelPolicy)
  },
  "fields": [
    {
      object (Field)
    }
  ],
  "learnMoreUri": string,
  "lockStatus": {
    object (LockStatus)
  }
}
필드
name

string

출력 전용. 라벨의 리소스 이름입니다. 요청에 따라 labels/{id} 또는 labels/{id}@{revisionId} 형식입니다. 아래의 idrevisionId를 참고하세요.

id

string

출력 전용. 이 라벨의 전역 고유 식별자입니다. ID는 name 라벨의 일부를 구성하지만 name와 달리 ID는 버전 간에 일관됩니다. 다음 정규식과 일치합니다. ([a-zA-Z0-9])+

revisionId

string

출력 전용. 라벨의 버전 ID입니다. 발행된 요청에 따라 버전 ID가 name 라벨의 일부일 수 있습니다. 라벨의 수정된 속성이 변경될 때마다 새 버전이 생성됩니다. 다음 정규식과 일치합니다. ([a-zA-Z0-9])+

labelType

enum (LabelType)

필수 항목입니다. 라벨 유형입니다.

creator

object (UserInfo)

출력 전용. 라벨을 만든 사용자입니다.

createTime

string (Timestamp format)

출력 전용. 라벨이 생성된 시간입니다.

revisionCreator

object (UserInfo)

출력 전용. 이 라벨 버전을 만든 사용자입니다.

revisionCreateTime

string (Timestamp format)

출력 전용. 이 라벨 버전이 생성된 시간입니다.

publisher

object (UserInfo)

출력 전용. 이 라벨을 게시한 사용자입니다. 이 값은 라벨이 게시되지 않은 경우 의미가 없습니다.

publishTime

string (Timestamp format)

출력 전용. 이 라벨이 게시된 시간입니다. 이 값은 라벨이 게시되지 않은 경우 의미가 없습니다.

disabler

object (UserInfo)

출력 전용. 이 라벨을 사용 중지한 사용자입니다. 이 값은 라벨이 사용 중지되지 않은 경우 의미가 없습니다.

disableTime

string (Timestamp format)

출력 전용. 라벨이 사용 중지된 시간입니다. 이 값은 라벨이 사용 중지되지 않은 경우 의미가 없습니다.

customer

string

출력 전용. 라벨이 속한 고객입니다. 예: 'customers/123abc789'

properties

object (Properties)

필수 항목입니다. 라벨의 기본 속성입니다.

lifecycle

object (Lifecycle)

출력 전용. 라벨의 게시, 지원 중단, 초안 변경사항이 있는지 여부를 포함한 라벨의 수명 주기 상태입니다.

displayHints

object (DisplayHints)

출력 전용. 라벨을 렌더링하기 위한 UI 표시 힌트

appliedCapabilities

object (AppliedCapabilities)

출력 전용. 적용된 메타데이터의 이 라벨과 관련된 기능입니다.

schemaCapabilities

object (SchemaCapabilities)

출력 전용. 사용자가 이 라벨에 대해 사용할 수 있는 기능입니다.

appliedLabelPolicy

object (AppliedLabelPolicy)

출력 전용. 라벨이 Drive 항목에 적용될 때 이 라벨의 동작입니다.

fields[]

object (Field)

우선순위가 내림차순의 필드 목록입니다.

learnMoreUri

string

사용자가 이 라벨과 라벨 사용 방법을 자세히 알아볼 수 있도록 표시할 맞춤 URL입니다.

lockStatus

object (LockStatus)

출력 전용. 이 라벨의 LockStatus입니다.

LabelType

이 라벨의 유형입니다.

열거형
LABEL_TYPE_UNSPECIFIED 알 수 없는 라벨 유형입니다.
SHARED 공유 라벨은 Drive 항목에 적용하기 위해 사용자와 공유할 수 있습니다.
ADMIN 관리자 소유 라벨입니다. 관리자만 만들고 수정할 수 있습니다. 일부 추가적인 관리자 전용 기능을 지원합니다.

UserInfo

사용자에 관한 정보입니다.

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

string

People API에서 추가 정보를 얻기 위해 사용할 수 있는 사용자의 식별자입니다. 예: people/12345678

속성

라벨의 기본 속성입니다.

JSON 표현
{
  "title": string,
  "description": string
}
필드
title

string

필수 항목입니다. 라벨 제목입니다.

description

string

라벨의 설명입니다.

수명 주기

라벨, 필드, 선택 등 객체의 수명 주기 상태입니다. 수명 주기는 다음과 같은 전환을 적용합니다.

  • UNPUBLISHED_DRAFT (시작 상태)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (삭제됨)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (삭제됨)

게시됨 상태와 사용 중지 상태에는 뚜렷한 특징이 있습니다.

  • 게시됨 - 이 상태의 객체에 몇 가지 변경사항이 적용될 수 있으며, 이 경우 hasUnpublishedChanges가 true입니다. 또한 일부 변경은 허용되지 않습니다. 일반적으로 라벨과 관련된 기존 메타데이터를 무효화하거나 새로운 제한을 야기하는 변경사항은 거부됩니다.
  • 사용 중지: 사용 중지하면 구성된 DisabledPolicy이 적용됩니다.
JSON 표현
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
필드
state

enum (State)

출력 전용. 이 수명 주기와 연결된 객체의 상태입니다.

hasUnpublishedChanges

boolean

출력 전용. 이 수명 주기와 연결된 객체에 게시되지 않은 변경사항이 있는지 여부입니다.

disabledPolicy

object (DisabledPolicy)

사용 중지된 라벨, 필드 또는 선택 항목을 표시하는 방법을 관리하는 정책입니다.

상태

이 수명 주기와 연결된 객체의 상태입니다.

열거형
STATE_UNSPECIFIED 알 수 없는 상태입니다.
UNPUBLISHED_DRAFT 객체의 초기 상태입니다. 게시된 객체는 절대 이 상태로 돌아갈 수 없습니다. 객체가 게시되면 특정 유형의 변경사항은 더 이상 허용되지 않습니다.
PUBLISHED 객체가 게시되었습니다. 객체에 hasUnpublishedChanges로 표시된 것처럼 게시되지 않은 초안 변경사항이 있을 수 있습니다.
DISABLED 객체가 게시되었으며 사용 중지되었습니다. 객체에 hasUnpublishedChanges로 표시된 것처럼 게시되지 않은 초안 변경사항이 있을 수 있습니다.
DELETED 객체가 삭제되었습니다.

DisabledPolicy

다양한 컨텍스트에서 사용 중지된 라벨, 필드 또는 선택 항목을 처리하는 방법을 제어하는 정책입니다.

JSON 표현
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
필드
showInApply

boolean

Drive 항목의 적용 메뉴에 사용 중지된 이 객체를 표시할지 여부입니다.

  • true인 경우 객체는 일반적으로 UI에 사용 중지로 표시되고 선택할 수 없습니다.
  • false인 경우 일반적으로 객체는 UI에 숨겨집니다.

DisplayHints

라벨을 렌더링하기 위한 UI 표시 힌트

JSON 표현
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
필드
disabled

boolean

UI에 라벨을 사용 중지로 표시할지 여부입니다.

shownInApply

boolean

이 라벨은 Drive 항목에 값을 적용할 때 적용 메뉴에 표시되어야 합니다.

priority

string (int64 format)

목록에 라벨을 표시하는 순서입니다.

AppliedCapabilities

사용자가 이 라벨의 적용된 메타데이터에 대해 사용할 수 있는 기능입니다.

JSON 표현
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
필드
canRead

boolean

사용자가 이 라벨과 관련된 적용된 메타데이터를 읽을 수 있는지 여부입니다.

canApply

boolean

사용자가 이 라벨을 항목에 적용할 수 있는지 여부입니다.

canRemove

boolean

사용자가 항목에서 이 라벨을 삭제할 수 있는지 여부입니다.

SchemaCapabilities

라벨을 수정할 때 이 라벨과 관련된 기능입니다.

JSON 표현
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
필드
canUpdate

boolean

사용자가 이 라벨을 변경할 수 있는지 여부입니다.

canDelete

boolean

사용자가 이 라벨을 삭제할 수 있는지 여부입니다. 사용자에게 권한이 있어야 하며 라벨은 사용 중지되어야 합니다.

canDisable

boolean

사용자가 이 라벨을 사용 중지할 수 있는지 여부입니다. 사용자에게 권한이 있어야 하며 이 라벨을 이미 사용 중지하면 안 됩니다.

canEnable

boolean

사용자가 이 라벨을 사용 설정할 수 있는지 여부입니다. 사용자에게 권한이 있어야 하며 이 라벨은 사용 중지되어야 합니다.

AppliedLabelPolicy

라벨이 Drive 항목에 적용될 때 이 라벨의 동작입니다.

JSON 표현
{
  "copyMode": enum (CopyMode)
}
필드
copyMode

enum (CopyMode)

Drive 항목을 복사할 때 적용된 라벨 및 필드 값을 복사하는 방법을 나타냅니다.

CopyMode

Drive 항목을 복사할 때 적용된 라벨 및 필드 값을 복사하는 방법을 나타냅니다.

열거형
COPY_MODE_UNSPECIFIED 복사 모드가 지정되지 않았습니다.
DO_NOT_COPY 적용된 라벨 및 필드 값은 라벨이 적용된 Drive 항목을 복사할 때 기본적으로 복사되지 않습니다.
ALWAYS_COPY 적용된 라벨과 필드 값은 라벨이 적용된 Drive 항목이 복사될 때 항상 복사됩니다. 이 모드는 관리자만 사용할 수 있습니다.
COPY_APPLIABLE 복사하는 사용자가 라벨을 적용할 수 있는 경우 적용된 라벨 및 필드 값이 복사됩니다.

필드

표시 이름, 데이터 유형, 기타 구성 옵션이 있는 필드를 정의합니다. 이 필드는 Drive 항목에 설정될 수 있는 메타데이터의 종류를 정의합니다.

JSON 표현
{
  "id": string,
  "queryKey": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  },

  // Union field type 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.
}
필드
id

string

출력 전용. 라벨 또는 라이브러리 내에서 고유한 필드의 키입니다.

이 값은 자동 생성됩니다. 다음 정규식과 일치합니다. ([a-zA-Z0-9])+

queryKey

string

출력 전용. 파일에서 이 필드에 정의된 값을 기반으로 파일을 찾기 위해 Drive 검색어를 구성할 때 사용하는 키입니다. 예: '{queryKey} > 2001-01-01'

properties

object (Properties)

필드의 기본 속성입니다.

lifecycle

object (Lifecycle)

출력 전용. 이 필드의 수명 주기입니다.

displayHints

object (DisplayHints)

출력 전용. 필드 렌더링을 위한 UI 표시 힌트

schemaCapabilities

object (SchemaCapabilities)

출력 전용. 이 필드를 수정할 때 이 사용자가 사용할 수 있는 권한입니다.

appliedCapabilities

object (AppliedCapabilities)

출력 전용. 이 입력란에서 사용자가 사용할 수 있는 권한 및 라벨이 Drive 항목에 적용될 때의 값입니다.

creator

object (UserInfo)

출력 전용. 이 필드를 만든 사용자입니다.

createTime

string (Timestamp format)

출력 전용. 이 필드가 생성된 시간입니다.

updater

object (UserInfo)

출력 전용. 이 필드를 수정한 사용자입니다.

updateTime

string (Timestamp format)

출력 전용. 이 필드가 업데이트된 시간입니다.

publisher

object (UserInfo)

출력 전용. 이 필드를 게시한 사용자입니다. 필드가 게시되지 않으면 이 값은 의미가 없습니다.

disabler

object (UserInfo)

출력 전용. 이 필드를 사용 중지한 사용자입니다. 필드가 사용 중지되지 않으면 이 값은 의미가 없습니다.

disableTime

string (Timestamp format)

출력 전용. 이 필드가 사용 중지된 시간입니다. 필드가 사용 중지되지 않으면 이 값은 의미가 없습니다.

lockStatus

object (LockStatus)

출력 전용. 이 필드의 LockStatus입니다.

통합 필드 type. 이 필드의 데이터 유형 및 옵션입니다. 게시한 데이터 유형은 변경할 수 없습니다. type은 다음 중 하나여야 합니다.
textOptions

object (TextOptions)

텍스트 필드 옵션입니다.

integerOptions

object (IntegerOptions)

정수 필드 옵션입니다.

dateOptions

object (DateOptions)

날짜 필드 옵션입니다.

selectionOptions

object (SelectionOptions)

선택 필드 옵션

userOptions

object (UserOptions)

사용자 필드 옵션입니다.

TextOptions

텍스트 필드 유형 옵션입니다.

JSON 표현
{
  "minLength": integer,
  "maxLength": integer
}
필드
minLength

integer

출력 전용. 텍스트 필드 값의 최소 유효 길이입니다.

maxLength

integer

출력 전용. 텍스트 필드 값의 최대 유효 길이입니다.

IntegerOptions

정수 필드 유형의 옵션입니다.

JSON 표현
{
  "minValue": string,
  "maxValue": string
}
필드
minValue

string (int64 format)

출력 전용. 정수 필드의 최소 유효 값입니다.

maxValue

string (int64 format)

출력 전용. 정수 필드의 유효한 최댓값입니다.

DateOptions

날짜 필드 유형 옵션입니다.

JSON 표현
{
  "dateFormatType": enum (DateFormat),
  "dateFormat": string,
  "minValue": {
    object (Date)
  },
  "maxValue": {
    object (Date)
  }
}
필드
dateFormatType

enum (DateFormat)

현지화된 날짜 형식 옵션 필드 값은 언어에 따라 이 형식으로 렌더링됩니다.

dateFormat

string

출력 전용. ICU 날짜 형식입니다.

minValue

object (Date)

출력 전용. 최소 유효 값 (연도, 월, 일)입니다.

maxValue

object (Date)

출력 전용. 최대 유효 값 (연, 월, 일)입니다.

DateFormat

현지화된 날짜 형식 옵션

열거형
DATE_FORMAT_UNSPECIFIED 날짜 형식이 지정되지 않았습니다.
LONG_DATE 전체 월 이름을 포함합니다. 예: 1999년 1월 12일 (MMMM d, y)
SHORT_DATE Short, 숫자, 대표입니다. 예: 12/13/99 (M/d/yy)

SelectionOptions

선택 필드 유형의 옵션입니다.

JSON 표현
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
필드
listOptions

object (ListOptions)

이 플래그를 지정하면 이 필드가 값 목록을 지원함을 나타냅니다. 필드가 게시된 후에는 변경할 수 없습니다.

choices[]

object (Choice)

이 선택 필드에 사용할 수 있는 옵션입니다. 목록 순서는 일관되고 insertBeforeChoice로 수정됩니다.

ListOptions

연결된 필드 유형의 다중 값 변형에 대한 옵션입니다.

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

integer

허용되는 최대 항목 수입니다.

원하는 대로 선택

선택 필드 선택입니다.

JSON 표현
{
  "id": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  }
}
필드
id

string

선택한 고유한 값입니다. 자동 생성된 ID입니다. 다음 정규식과 일치합니다: ([a-zA-Z0-9_])+.

properties

object (Properties)

원하는 기본 속성입니다.

lifecycle

object (Lifecycle)

출력 전용. 선택의 수명 주기입니다.

displayHints

object (DisplayHints)

출력 전용. 선택 항목을 렌더링하기 위한 UI 표시 힌트

schemaCapabilities

object (SchemaCapabilities)

출력 전용. 옵션을 수정할 때 이 옵션과 관련된 기능입니다.

appliedCapabilities

object (AppliedCapabilities)

출력 전용. 적용된 메타데이터에서 이 선택과 관련된 기능입니다.

creator

object (UserInfo)

출력 전용. 이 옵션을 만든 사용자입니다.

createTime

string (Timestamp format)

출력 전용. 이 선택이 생성된 시간입니다.

updater

object (UserInfo)

출력 전용. 이 선택사항을 마지막으로 업데이트한 사용자입니다.

updateTime

string (Timestamp format)

출력 전용. 이 선택이 마지막으로 업데이트된 시간입니다.

publisher

object (UserInfo)

출력 전용. 이 선택 항목을 게시한 사용자입니다. 선택 항목이 게시되지 않은 경우에는 이 값이 의미가 없습니다.

publishTime

string (Timestamp format)

출력 전용. 이 선택이 게시된 시간입니다. 선택 항목이 게시되지 않은 경우에는 이 값이 의미가 없습니다.

disabler

object (UserInfo)

출력 전용. 이 선택을 사용 중지한 사용자입니다. 이 값은 옵션이 사용 중지되지 않은 경우 의미가 없습니다.

disableTime

string (Timestamp format)

출력 전용. 선택이 사용 중지된 시간입니다. 선택 항목이 사용 중지되지 않은 경우 이 값은 의미가 없습니다.

lockStatus

object (LockStatus)

출력 전용. 선택한 LockStatus입니다.

속성

원하는 기본 속성입니다.

JSON 표현
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
필드
displayName

string

필수 항목입니다. 이 필드를 식별하는 UI에 표시할 표시 텍스트입니다.

description

string

이 라벨의 설명입니다.

badgeConfig

object (BadgeConfig)

이 선택 항목의 배지 구성입니다. 설정된 경우 이 선택 항목을 소유한 라벨은 '배지가 있는 라벨'로 간주됩니다.

insertBeforeChoice

string

입력 전용. 표시된 선택 항목 앞에 이 선택 항목을 삽입하거나 이동합니다. 비어 있으면 목록의 끝에 표시됩니다.

BadgeConfig

라벨의 배지 상태입니다.

JSON 표현
{
  "color": {
    object (Color)
  },
  "priorityOverride": string
}
필드
color

object (Color)

배지의 색상입니다. 지정하지 않으면 배지가 렌더링되지 않습니다. 여기에 설정된 배경, 전경, 단독 (밝은 모드 및 어두운 모드) 색상이 Drive UI에서 지원되는 가장 가까운 색상으로 변경됩니다.

priorityOverride

string (int64 format)

이 배지의 기본 전역 우선순위를 재정의합니다. 0으로 설정하면 기본 우선순위 휴리스틱이 사용됩니다.

DisplayHints

옵션을 렌더링하기 위한 UI 표시 힌트

JSON 표현
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "badgeColors": {
    object (BadgeColors)
  },
  "darkBadgeColors": {
    object (BadgeColors)
  },
  "badgePriority": string
}
필드
disabled

boolean

UI에서 옵션을 사용 중지로 표시할지 여부입니다.

shownInApply

boolean

이 옵션은 Drive 항목에 값을 적용할 때 적용 메뉴에 표시되어야 합니다.

badgeColors

object (BadgeColors)

배지에 사용할 색상입니다. 선택한 properties.badge_config.color에 따라 Google Material 색상으로 변경되었습니다.

darkBadgeColors

object (BadgeColors)

배지에 사용할 어두운 모드 색상입니다. 선택한 properties.badge_config.color에 따라 Google Material 색상으로 변경되었습니다.

badgePriority

string (int64 format)

이 배지의 우선순위입니다. 여러 배지를 비교하고 정렬하는 데 사용됩니다. 숫자가 낮을수록 배지가 먼저 표시됩니다. 배지 구성이 없으면 0이 됩니다. 그렇지 않으면 라벨 생성 날짜, 필드, 옵션 우선순위를 선호하는 기본 휴리스틱인 BadgeConfig.priority_override으로 설정됩니다.

BadgeColors

BadgeConfig에서 파생된 색상이며 지원되는 가장 가까운 권장 색상으로 변경됨

JSON 표현
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
필드
backgroundColor

object (Color)

출력 전용. 포그라운드와 페어링되는 배지 배경

foregroundColor

object (Color)

출력 전용. 배경과 페어링되는 배지 포그라운드

soloColor

object (Color)

출력 전용. 배경이 없는 텍스트에 사용할 수 있는 색상입니다.

SchemaCapabilities

선택 항목을 수정할 때 선택 항목과 관련된 기능입니다.

JSON 표현
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
필드
canUpdate

boolean

사용자가 이 선택사항을 업데이트할 수 있는지 여부입니다.

canDelete

boolean

사용자가 이 선택을 삭제할 수 있는지 여부입니다.

canDisable

boolean

사용자가 이 선택을 사용 중지할 수 있는지 여부입니다.

canEnable

boolean

사용자가 이 선택을 사용 설정할 수 있는지 여부입니다.

AppliedCapabilities

적용된 메타데이터에서 이 선택과 관련된 기능입니다.

JSON 표현
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
필드
canRead

boolean

사용자가 항목의 관련 적용된 메타데이터를 읽을 수 있는지 여부입니다.

canSelect

boolean

사용자가 항목에서 이 옵션을 선택할 수 있는지 여부입니다.

LockStatus

라벨 구성요소를 잠금으로 간주해야 하는지 여부에 대한 정보를 포함합니다.

JSON 표현
{
  "locked": boolean
}
필드
locked

boolean

출력 전용. 이 라벨 구성요소가 LabelLock의 (직접) 대상인지 여부를 나타냅니다. 라벨 구성요소는 LabelLock의 직접 대상이 아니더라도 암시적으로 잠길 수 있으며, 이때 이 필드는 false로 설정됩니다.

UserOptions

사용자 필드 유형 옵션입니다.

JSON 표현
{
  "listOptions": {
    object (ListOptions)
  }
}
필드
listOptions

object (ListOptions)

지정된 경우 이 필드가 값 목록을 지원함을 나타냅니다. 필드가 게시된 후에는 변경할 수 없습니다.

속성

필드의 기본 속성입니다.

JSON 표현
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
필드
displayName

string

필수 항목입니다. 이 필드를 식별하는 UI에 표시할 표시 텍스트입니다.

required

boolean

필드를 필수로 표시할지 여부입니다.

insertBeforeField

string

입력 전용. 표시된 입력란 앞에 이 입력란을 삽입하거나 이동합니다. 비어 있으면 필드가 목록의 끝에 배치됩니다.

DisplayHints

필드 렌더링을 위한 UI 표시 힌트

JSON 표현
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
필드
required

boolean

필드를 UI에서 필요에 따라 표시해야 하는지 여부입니다.

disabled

boolean

필드를 사용 중지로 UI에 표시해야 하는지 여부입니다.

shownInApply

boolean

이 필드는 Drive 항목에 값을 적용할 때 적용 메뉴에 표시되어야 합니다.

SchemaCapabilities

필드를 수정할 때 이 필드와 관련된 기능입니다.

JSON 표현
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
필드
canUpdate

boolean

사용자가 이 필드를 변경할 수 있는지 여부입니다.

canDelete

boolean

사용자가 이 필드를 삭제할 수 있는지 여부입니다. 사용자에게 권한이 있어야 하며 필드는 지원 중단되어야 합니다.

canDisable

boolean

사용자가 이 필드를 사용 중지할 수 있는지 여부입니다. 사용자에게 권한이 있어야 하며 이 필드가 이미 사용 중지되어 있으면 안 됩니다.

canEnable

boolean

사용자가 이 필드를 사용 설정할 수 있는지 여부입니다. 사용자에게 권한이 있어야 하며 이 필드는 사용 중지해야 합니다.

AppliedCapabilities

적용된 메타데이터에서 이 필드와 관련된 기능입니다.

JSON 표현
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
필드
canRead

boolean

사용자가 항목의 관련 적용된 메타데이터를 읽을 수 있는지 여부입니다.

canWrite

boolean

사용자가 Drive 항목에 이 필드를 설정할 수 있는지 여부입니다.

방법

create

새 라벨을 만듭니다.

delete

Drive 항목의 라벨 및 관련 메타데이터를 완전히 삭제합니다.

delta

일련의 업데이트 요청을 적용하여 단일 라벨을 업데이트하여 새 초안 버전이 생성됩니다.

disable

게시된 라벨을 사용 중지합니다.

enable

사용 중지된 라벨을 사용 설정하고 게시된 상태로 복원합니다.

get

리소스 이름으로 라벨을 가져옵니다.

list

라벨 나열

publish

모든 초안 변경사항을 라벨에 게시합니다.

updateLabelCopyMode

라벨의 CopyMode를 업데이트합니다.

updatePermissions

라벨의 권한을 업데이트합니다.