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로 설정된 라벨에만 사용할 수 있습니다.

MessageListVisibility

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

LabelListVisibility

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

유형

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

색상

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

string

16진수 문자열로 표현되는 라벨의 텍스트 색상입니다. 이 필드는 라벨의 색상을 설정하는 데 필요합니다. #e
backgroundColor

string

16진수 문자열 #RRGGBB (예: #000000)로 표시되는 배경 색상입니다. 이 필드는 라벨의 색상을 설정하는 데 필요합니다. #e

방법

create

 새 라벨을 만듭니다.

delete

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

get

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

list

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

patch

 지정된 라벨에 패치를 적용합니다.

update

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