라벨을 사용하여 Gmail의 메일 및 대화목록에 태그를 지정하고, 정리하고, 분류할 수 있습니다. 라벨은 메시지 및 대화목록과 다대다 관계가 있습니다. 단일 메시지 또는 대화목록에 여러 라벨을 적용하고, 여러 메시지 또는 대화목록에 단일 라벨을 적용할 수 있습니다.
라벨을 만들기, 가져오기, 나열, 업데이트, 삭제하는 방법은 라벨 참조를 확인하세요.
라벨을 관리하려면 https://www.googleapis.com/auth/gmail.labels 범위를 사용해야 합니다. 범위에 대한 자세한 내용은 Gmail API별 승인 및 인증 정보를 참조하세요.
라벨 유형
라벨에는 예약된 SYSTEM 라벨과 맞춤 USER 라벨이 있습니다.
시스템 라벨은 일반적으로 받은편지함과 같은 Gmail 웹 인터페이스의 사전 정의된 요소에 해당합니다. 시스템 라벨 이름은 예약되어 있으므로 SYSTEM 라벨과 동일한 이름으로 USER 라벨을 만들 수 없습니다. 다음 표에는 가장 일반적인 몇 가지 Gmail 시스템 라벨이 나와 있습니다.
| 이름 | 수동으로 적용 가능 | Notes |
|---|---|---|
INBOX |
예 | |
SPAM |
예 | |
TRASH |
예 | |
UNREAD |
예 | |
STARRED |
예 | |
IMPORTANT |
예 | |
SENT |
아니요 | drafts.send 또는 messages.send를 사용하여 전송되거나, messages.insert로 삽입되거나, From 헤더에 사용자의 이메일이 삽입되거나, 사용자가 웹 인터페이스를 통해 보낸 메시지에 자동으로 적용됩니다. |
DRAFT |
아니요 | Gmail API 또는 Gmail 인터페이스로 만든 모든 draft 메시지에 자동으로 적용됩니다. |
CATEGORY_PERSONAL |
예 | Gmail 인터페이스의 개인 탭에 표시되는 메시지에 해당합니다. |
CATEGORY_SOCIAL |
예 | Gmail 인터페이스의 소셜 탭에 표시되는 메시지에 해당합니다. |
CATEGORY_PROMOTIONS |
예 | Gmail 인터페이스의 프로모션 탭에 표시되는 메시지에 해당합니다. |
CATEGORY_UPDATES |
예 | Gmail 인터페이스의 업데이트 탭에 표시되는 메시지에 해당합니다. |
CATEGORY_FORUMS |
예 | Gmail 인터페이스의 포럼 탭에 표시되는 메시지에 해당합니다. |
메시지 및 대화목록의 라벨 관리하기
라벨은 메일에만 존재합니다. 예를 들어 대화목록의 라벨을 나열하면 대화목록 내 메시지에 있는 라벨 목록이 표시됩니다. 대화목록 내의 모든 메시지에 라벨이 없는 경우도 있습니다. 메시지에 여러 라벨을 적용할 수 있지만 임시보관 메시지에 라벨을 적용할 수는 없습니다.
대화목록에 라벨 추가 또는 삭제하기
대화목록에 라벨을 추가하거나 삭제할 때는 대화목록의 모든 기존 메시지에 지정된 라벨을 추가하거나 삭제합니다.
라벨을 추가한 후 대화목록에 메시지가 추가되면 새 메시지는 대화목록과 연결된 기존 라벨을 상속하지 않습니다. 이러한 메시지에 라벨을 추가하려면 대화목록에 라벨을 다시 추가하세요.
스레드와 연결된 라벨을 추가하거나 삭제하려면 threads.modify를 사용합니다.
메일에 라벨 추가 또는 삭제하기
메시지에 라벨을 추가하면 해당 메시지에 라벨이 추가되고 메시지가 속한 대화목록과 연결됩니다. 이 라벨은 대화목록 내의 다른 메시지에 추가되지 않습니다.
대화목록에서 라벨이 지정된 유일한 메시지인 메시지의 라벨을 삭제하면 해당 라벨이 대화목록에서도 삭제됩니다.
메시지에 적용된 라벨을 추가하거나 삭제하려면 messages.modify를 사용합니다.