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