리소스: 라벨
라벨은 사용자의 편지함에 있는 메일과 대화목록을 분류하는 데 사용됩니다. 사용자의 편지함에 지원되는 최대 라벨 수는 10,000개입니다.
JSON 표현 |
---|
{ "id": string, "name": string, "messageListVisibility": enum ( |
필드 | |
---|---|
id |
변경할 수 없는 라벨 ID입니다. |
name |
라벨의 표시 이름입니다. |
messageListVisibility |
Gmail 웹 인터페이스의 메일 목록에서 이 라벨이 지정된 메일의 공개 상태입니다. |
labelListVisibility |
Gmail 웹 인터페이스의 라벨 목록에 있는 라벨의 공개 상태입니다. |
type |
라벨의 소유자 유형입니다. 사용자 라벨은 사용자가 만들고 수정 및 삭제할 수 있으며 모든 메시지 또는 대화목록에 적용될 수 있습니다. 시스템 라벨은 내부적으로 생성되며 추가, 수정, 삭제할 수 없습니다. 경우에 따라 메일 및 대화목록에 시스템 라벨을 적용하거나 삭제할 수 있지만 반드시 적용되는 것은 아닙니다. 예를 들어 사용자는 메일 및 대화목록에서 |
messagesTotal |
라벨이 있는 메시지의 총 개수입니다. |
messagesUnread |
라벨이 있는 읽지 않은 메일 수. |
threadsTotal |
라벨이 있는 총 스레드 수입니다. |
threadsUnread |
라벨이 있는 읽지 않은 대화목록의 수입니다. |
color |
라벨에 지정할 색상입니다. 색상은 |
MessageListVisibility
열거형 | |
---|---|
show |
메일 목록에 라벨을 표시합니다. |
hide |
메일 목록에 라벨을 표시하지 않습니다. |
LabelListVisibility
열거형 | |
---|---|
labelShow |
라벨 목록에 라벨을 표시합니다. |
labelShowIfUnread |
해당 라벨이 지정된 읽지 않은 메일이 있는 경우 라벨을 표시합니다. |
labelHide |
라벨 목록에 라벨을 표시하지 않습니다. |
유형
열거형 | |
---|---|
system |
Gmail에서 만든 라벨 |
user |
사용자 또는 애플리케이션에서 만든 맞춤 라벨입니다. |
색상
JSON 표현 |
---|
{ "textColor": string, "backgroundColor": string } |
필드 | |
---|---|
textColor |
16진수 문자열로 표현되는 라벨의 텍스트 색상입니다. 이 필드는 라벨의 색상을 설정하는 데 필요합니다. #e |
backgroundColor |
16진수 문자열 #RRGGBB (예: #000000)로 표시되는 배경 색상입니다. 이 필드는 라벨의 색상을 설정하는 데 필요합니다. #e |
방법 |
|
---|---|
|
새 라벨을 만듭니다. |
|
지정한 라벨을 즉시 영구적으로 삭제하고 라벨이 적용되는 모든 메일 및 대화목록에서 삭제됩니다. |
|
지정된 라벨을 가져옵니다. |
|
사용자 편지함의 모든 라벨을 나열합니다. |
|
지정된 라벨에 패치를 적용합니다. |
|
지정된 라벨을 업데이트합니다. |