라벨을 사용하면 Gmail에서 메일과 대화목록을 태그하고 정리하고 분류할 수 있습니다. 라벨은 메일 및 대화목록과 다대다 관계를 갖습니다. 단일 메일 또는 대화목록에 여러 라벨을 적용할 수 있고 여러 메일 또는 대화목록에 단일 라벨을 적용할 수 있습니다.
라벨을 만들기, 가져오기, 나열하기, 업데이트하기 또는 삭제하기하는 방법에 관한 자세한 내용은 라벨 참조를 참고하세요.
라벨을 관리하려면 https://www.googleapis.com/auth/gmail.labels 범위를 사용해야 합니다. 범위에 대한 자세한 내용은 Gmail API별 승인 및 인증 정보를 참고하세요.
라벨 유형
라벨에는 예약된 SYSTEM 라벨과 맞춤 USER 라벨의 두 가지 종류가 있습니다.
시스템 라벨은 일반적으로 Gmail 웹 인터페이스의 미리 정의된 요소(예: 받은편지함)에 해당합니다. 시스템 라벨 이름은 예약되어 있으므로 SYSTEM 라벨과 이름이 동일한 USER 라벨을 만들 수 없습니다. 다음 표에는 가장 일반적인 Gmail 시스템 라벨이 나열되어 있습니다.
| 이름 | 수동으로 적용할 수 있음 | 참고 |
|---|---|---|
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를 사용합니다.