라벨을 사용하여 Gmail에서 메일 및 대화목록을 태그하고 정리하고 분류할 수 있습니다. 라벨은 메시지 및 대화목록과 다대다 관계가 있습니다. 단일 메시지 또는 대화목록에 여러 개의 라벨을 적용하고 여러 메시지 또는 대화목록에 단일 라벨을 적용할 수 있습니다.
라벨을 create, 가져오거나, 나열하거나, 업데이트하거나, 삭제하는 방법에 관한 자세한 내용은 라벨 참조를 참고하세요.
라벨을 관리하려면 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로 전송되거나, From 헤더에 messages.insert 및 사용자의 이메일과 함께 삽입되거나, 사용자가 웹 인터페이스를 통해 전송한 메일에 자동으로 적용됩니다. |
DRAFT |
아니요 | Gmail API 또는 Gmail 인터페이스로 만든 모든 draft 메일에 자동으로 적용됩니다. |
CATEGORY_PERSONAL |
예 | Gmail 인터페이스의 개인 탭에 표시되는 메일에 해당합니다. |
CATEGORY_SOCIAL |
예 | Gmail 인터페이스의 소셜 탭에 표시되는 메일에 해당합니다. |
CATEGORY_PROMOTIONS |
예 | Gmail 인터페이스의 프로모션 탭에 표시되는 메일에 해당합니다. |
CATEGORY_UPDATES |
예 | Gmail 인터페이스의 업데이트 탭에 표시되는 메일에 해당합니다. |
CATEGORY_FORUMS |
예 | Gmail 인터페이스의 포럼 탭에 표시되는 메일에 해당합니다. |
메시지 및 대화목록에서 라벨 관리하기
라벨은 메일에만 있습니다. 예를 들어 대화목록에 라벨을 나열하면 대화목록 내의 메시지에 있는 라벨 목록을 가져옵니다. 대화목록 내의 모든 메시지에 라벨이 표시되지 않을 수 있습니다. 메시지에 여러 개의 라벨을 적용할 수 있지만 메시지 초안에 라벨을 적용할 수는 없습니다.
대화목록에 라벨 추가 또는 삭제하기
대화목록에 라벨을 추가하거나 삭제하면 대화목록의 모든 기존 메시지에 지정된 라벨을 추가하거나 삭제합니다.
라벨을 추가한 후에 대화목록에 메시지가 추가되면 새 메시지는 대화목록과 연결된 기존 라벨을 상속받지 않습니다. 이러한 메시지에 라벨을 추가하려면 대화목록에 라벨을 다시 추가합니다.
대화목록과 연결된 라벨을 추가하거나 삭제하려면 threads.modify를 사용합니다.
메일에 라벨 추가 또는 삭제하기
메일에 라벨을 추가하면 라벨이 해당 메일에 추가되고 메일이 속한 대화목록과 연결됩니다. 대화목록 내의 다른 메시지에 라벨이 추가되지 않습니다.
메일에서 라벨을 삭제했는데 해당 라벨이 대화목록에 있는 유일한 메일인 경우 대화목록에서도 라벨이 삭제됩니다.
메일에 적용된 라벨을 추가하거나 삭제하려면 messages.modify를 사용합니다.