REST Resource: labels

리소스: 라벨

라벨은 Drive 항목을 정리하고 검색하기 위해 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)
  },
  "enabledAppSettings": {
    object (EnabledAppSettings)
  }
}
필드
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입니다.

enabledAppSettings

object (EnabledAppSettings)

선택사항입니다. 이 라벨의 EnabledAppSettings입니다.

LabelType

이 라벨의 유형입니다.

열거형
LABEL_TYPE_UNSPECIFIED 알 수 없는 라벨 유형입니다.
SHARED 공유 라벨은 Drive 항목에 적용할 수 있도록 사용자와 공유될 수 있습니다.
ADMIN 관리자가 소유한 라벨입니다. 관리자만 만들고 수정할 수 있습니다. 일부 추가 관리자 전용 기능을 지원합니다.
GOOGLE_APP 고객이 아닌 내부 Google 애플리케이션에서 소유한 라벨입니다. 이러한 라벨은 읽기 전용입니다.

사용자 정보

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

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

string

People API와 함께 사용하여 추가 정보를 가져올 수 있는 이 사용자의 식별자입니다. 예를 들면 people/12345678입니다.

속성

라벨의 기본 속성입니다.

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

string

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

description

string

라벨의 설명입니다.

Lifecycle

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

  • 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 짧은 숫자 표현입니다. 예: 12/13/99 (M/d/yy)

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.

month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.

day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

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으로 설정하면 기본 우선순위 휴리스틱이 사용됩니다.

색상

RGBA 색상 공간의 색상을 나타냅니다. 이 표현식은 간결함보다는 다양한 언어의 색상 표현식 간의 간편한 변환을 위해 설계되었습니다. 예를 들어 이 표현식의 필드는 Java의 java.awt.Color 생성자에 간단히 제공할 수 있습니다. iOS의 UIColor +colorWithRed:green:blue:alpha 메서드에도 간단히 제공할 수 있습니다. 또한 약간의 작업으로 JavaScript에서 CSS rgba() 문자열로 쉽게 형식을 지정할 수 있습니다.

이 참조 페이지에는 RGB 값을 해석하는 데 사용해야 하는 절대 색상 공간(예: sRGB, Adobe RGB, DCI-P3, BT.2020)에 대한 정보가 없습니다. 기본적으로 애플리케이션은 sRGB 색상 공간을 가정해야 합니다.

색상 등식을 결정해야 하는 경우 구현은 달리 문서화되지 않는 한 모든 빨간색, 녹색, 파란색, 알파 값이 각각 최대 1e-5만큼 차이가 있는 경우 두 색상을 동일하게 취급합니다.

예시(자바):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

예시(iOS / obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

예시(자바스크립트):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
JSON 표현
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
필드
red

number

[0, 1] 간격의 값으로 표시되는 색상의 빨간색 양입니다.

green

number

[0, 1] 간격의 값으로 표시되는 색상의 녹색 양입니다.

blue

number

[0, 1] 간격의 값으로 표시되는 색상의 파란색 양입니다.

alpha

number

픽셀에 적용해야 하는 이 색상의 비율입니다. 즉, 최종 픽셀 색상은 등식으로 정의됩니다.

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

즉, 1.0 값은 단색에 해당하는 반면 0.0 값은 완전히 투명한 색상에 해당합니다. 이 옵션은 단순한 부동 소수점 스칼라 대신 래퍼 메시지를 사용하므로 기본값과 설정되지 않은 값을 구분할 수 있습니다. 생략하면 이 색상 객체는 단색으로 렌더링됩니다 (알파 값이 1.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 항목에서 이 필드를 설정할 수 있는지 여부입니다.

EnabledAppSettings

라벨을 사용할 수 있는 Workspace 앱을 설명합니다.

JSON 표현
{
  "enabledApps": [
    {
      object (EnabledApp)
    }
  ]
}
필드
enabledApps[]

object (EnabledApp)

선택사항입니다. 라벨을 사용할 수 있는 앱 목록입니다.

EnabledApp

라벨을 사용할 수 있는 앱

JSON 표현
{
  "app": enum (App)
}
필드
app

enum (App)

선택사항입니다. 앱의 이름입니다.

라벨을 사용할 수 있는 Workspace 앱의 집합입니다.

열거형
APP_UNSPECIFIED 미지정
DRIVE Drive를 탭합니다.
GMAIL Gmail

메서드

create

새 라벨을 만듭니다.

delete

Drive 항목에서 라벨 및 관련 메타데이터를 영구적으로 삭제합니다.

delta

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

disable

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

enable

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

get

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

list

라벨을 나열합니다.

publish

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

updateLabelCopyMode

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

updateLabelEnabledAppSettings

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

updatePermissions

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