REST Resource: users.labels

리소스: 라벨

라벨은 사용자 편지함에 있는 메일과 대화목록을 분류하는 데 사용됩니다. 사용자의 편지함에 지원되는 최대 라벨 수는 10,000개입니다.

JSON 표현
{
  "id": string,
  "name": string,
  "messageListVisibility": enum (MessageListVisibility),
  "labelListVisibility": enum (LabelListVisibility),
  "type": enum (Type),
  "messagesTotal": integer,
  "messagesUnread": integer,
  "threadsTotal": integer,
  "threadsUnread": integer,
  "color": {
    object (Color)
  }
}
필드
id

string

변경할 수 없는 라벨의 ID입니다.

name

string

라벨의 표시 이름입니다.

messageListVisibility

enum (MessageListVisibility)

Gmail 웹 인터페이스의 메일 목록에서 이 라벨이 있는 메일의 공개 상태입니다.

labelListVisibility

enum (LabelListVisibility)

Gmail 웹 인터페이스의 라벨 목록에서 라벨의 공개 상태입니다.

type

enum (Type)

라벨의 소유자 유형입니다. 사용자 라벨은 사용자가 만들고 사용자가 수정 및 삭제할 수 있으며 모든 메일 또는 대화목록에 적용할 수 있습니다. 시스템 라벨은 내부적으로 생성되며 추가, 수정, 삭제할 수 없습니다. 경우에 따라 시스템 라벨이 메일 및 대화목록에 적용되거나 삭제될 수 있지만 반드시 그런 것은 아닙니다. 예를 들어 사용자는 메일과 대화목록에서 INBOXUNREAD 라벨을 적용 및 삭제할 수 있지만 메일 또는 대화목록에서 DRAFTS 또는 SENT 라벨을 적용하거나 삭제할 수는 없습니다.

messagesTotal

integer

라벨이 있는 전체 메일 수

messagesUnread

integer

라벨이 있는 읽지 않은 메일의 수입니다.

threadsTotal

integer

라벨이 있는 총 대화목록 수입니다.

threadsUnread

integer

라벨이 있는 읽지 않은 대화목록의 수입니다.

color

object (Color)

라벨에 할당할 색상입니다. 색상은 typeuser로 설정된 라벨에만 사용할 수 있습니다.

MessageListVisibility

열거형
show 메일 목록에 라벨을 표시합니다.
hide 메일 목록에 라벨을 표시하지 않습니다.

LabelListVisibility

열거형
labelShow 라벨 목록에 라벨을 표시합니다.
labelShowIfUnread 읽지 않은 메일이 있는 경우 해당 라벨을 표시합니다.
labelHide 라벨 목록에 라벨을 표시하지 않습니다.

유형

열거형
system Gmail에서 생성된 라벨입니다.
user 사용자 또는 애플리케이션이 만든 커스텀 라벨입니다.

색상

JSON 표현
{
  "textColor": string,
  "backgroundColor": string
}
필드
textColor

string

16진수 문자열로 표현되는 라벨의 텍스트 색상입니다. 라벨의 색상을 설정하려면 이 입력란이 필요합니다. 다음과 같이 사전 사전 정의된 색상 값 세트만 허용됩니다. 다음과 같은 사전 사전 정의된 색상 값 세트만 허용됩니다.
#00000000, #43434343, #00000000, #43434343, #6666666, #43434343, #6666666, #43434343, #6666666, #9999999, #666666.

backgroundColor

string

16진수 문자열 #RRGGBB (예: #000000)로 표시되는 배경 색상입니다. 라벨의 색상을 설정하려면 이 입력란이 필요합니다. 다음과 같이 사전 사전 정의된 색상 값 세트만 허용됩니다. 다음과 같은 사전 사전 정의된 색상 값 세트만 허용됩니다.
#00000000, #43434343, #00000000, #43434343, #6666666, #43434343, #6666666, #43434343, #6666666, #9999999, #666666.

메서드

create

새 라벨을 만듭니다.

delete

지정된 라벨을 즉시 영구적으로 삭제하고 라벨이 적용된 모든 메일 및 대화목록에서 라벨을 삭제합니다.

get

지정된 라벨을 가져옵니다.

list

사용자 편지함에 있는 모든 라벨을 나열합니다.

patch

지정된 라벨을 패치합니다.

update

지정된 라벨을 업데이트합니다.