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)

라벨의 소유자 유형입니다. 사용자 라벨은 사용자가 만들며 사용자가 수정 및 삭제할 수 있고 모든 메시지 또는 대화목록에 적용할 수 있습니다. 시스템 라벨은 내부적으로 생성되며 추가, 수정 또는 삭제할 수 없습니다. 경우에 따라 시스템 라벨을 메시지 및 대화목록에 적용하거나 삭제할 수 있지만 보장되지는 않습니다. 예를 들어 사용자는 메시지 및 대화목록에서 INBOX 및 UNREAD 라벨을 적용하고 삭제할 수 있지만 메시지 또는 대화목록에서 DRAFTS 또는 SENT 라벨을 적용하거나 삭제할 수는 없습니다.
messagesTotal

integer

라벨이 있는 메시지의 총 개수입니다.
messagesUnread

integer

라벨이 있는 읽지 않은 메시지 수
threadsTotal

integer

라벨이 있는 스레드의 총 개수입니다.
threadsUnread

integer

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

object (Color)

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

메시지 목록 가시성

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

라벨 목록 공개 상태

열거형
labelShow 라벨 목록에 라벨을 표시합니다.
labelShowIfUnread 이 라벨이 있는 읽지 않은 메시지가 있으면 라벨을 표시합니다.
labelHide 라벨 목록에 라벨을 표시하지 않습니다.

유형

열거형
system Gmail에서 만든 라벨.
user 사용자 또는 애플리케이션에서 만든 맞춤 라벨입니다.

색상

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

string

16진수 문자열로 표시되는 라벨의 텍스트 색상입니다. 이 입력란은 라벨의 색상을 설정하기 위해 필요합니다. 을 확인해 주세요.
backgroundColor

string

16진수 문자열 #RRGGBB로 표시된 배경 색상입니다 (예: #000000). 이 입력란은 라벨의 색상을 설정하기 위해 필요합니다. 을 확인해 주세요.

방법

create

 새 라벨을 만듭니다.

delete

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

get

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

list

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

patch

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

update

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