Bạn có thể dùng nhãn để gắn thẻ, sắp xếp và phân loại thư cũng như chuỗi thư trong Gmail. Nhãn có mối quan hệ nhiều-nhiều với thư và chuỗi thư: bạn có thể áp dụng nhiều nhãn cho một thư hoặc chuỗi thư và áp dụng một nhãn cho nhiều thư hoặc chuỗi thư.
Để biết thông tin về cách tạo, lấy, liệt kê, cập nhật hoặc xoá nhãn, hãy xem Tài liệu tham khảo về nhãn.
Để quản lý nhãn, bạn phải sử dụng phạm vi https://www.googleapis.com/auth/gmail.labels. Để biết thêm thông tin về các phạm vi, hãy xem Thông tin uỷ quyền và xác thực dành riêng cho Gmail API.
Các loại nhãn
Nhãn có hai loại: nhãn SYSTEM được đặt trước và nhãn USER tuỳ chỉnh.
Nhãn hệ thống thường tương ứng với các phần tử được xác định trước trong giao diện web của Gmail, chẳng hạn như hộp thư đến. Tên nhãn hệ thống là tên dành riêng; bạn không thể tạo nhãn USER có cùng tên với bất kỳ nhãn SYSTEM nào. Bảng sau đây liệt kê một số nhãn hệ thống phổ biến nhất trong Gmail:
| Tên | Có thể được áp dụng theo cách thủ công | Ghi chú |
|---|---|---|
INBOX |
có | |
SPAM |
có | |
TRASH |
có | |
UNREAD |
có | |
STARRED |
có | |
IMPORTANT |
có | |
SENT |
không | Tự động áp dụng cho những thư được gửi bằng drafts.send hoặc messages.send, được chèn bằng messages.insert và email của người dùng trong tiêu đề From hoặc do người dùng gửi qua giao diện web. |
DRAFT |
không | Tự động áp dụng cho tất cả các thư draft được tạo bằng API Gmail hoặc giao diện Gmail. |
CATEGORY_PERSONAL |
có | Tương ứng với những thư xuất hiện trong thẻ Cá nhân của giao diện Gmail. |
CATEGORY_SOCIAL |
có | Tương ứng với những thư xuất hiện trong thẻ Mạng xã hội của giao diện Gmail. |
CATEGORY_PROMOTIONS |
có | Tương ứng với những thông báo xuất hiện trong thẻ Quảng cáo của giao diện Gmail. |
CATEGORY_UPDATES |
có | Tương ứng với những thư xuất hiện trong thẻ Thông tin cập nhật của giao diện Gmail. |
CATEGORY_FORUMS |
có | Tương ứng với những thư xuất hiện trong thẻ Diễn đàn của giao diện Gmail. |
Quản lý nhãn trên thư và chuỗi thư
Nhãn chỉ có trên thư. Ví dụ: nếu liệt kê nhãn trên một chuỗi thư, bạn sẽ nhận được danh sách nhãn có trên bất kỳ thư nào trong chuỗi thư đó. Không phải tin nhắn nào trong một chuỗi cũng có nhãn. Bạn có thể áp dụng nhiều nhãn cho thư, nhưng không thể áp dụng nhãn cho thư nháp.
Thêm hoặc xoá nhãn khỏi chuỗi tin nhắn
Khi thêm hoặc xoá nhãn khỏi một chuỗi thư, bạn sẽ thêm hoặc xoá nhãn đã chỉ định khỏi tất cả thư hiện có trong chuỗi thư đó.
Nếu thư được thêm vào một chuỗi sau khi bạn thêm nhãn, thì thư mới sẽ không kế thừa nhãn hiện có được liên kết với chuỗi đó. Để thêm nhãn vào những thư đó, hãy thêm lại nhãn vào chuỗi thư.
Để thêm hoặc xoá nhãn liên kết với một chuỗi tin nhắn, hãy sử dụng biểu tượng threads.modify.
Thêm hoặc xoá nhãn khỏi thư
Khi bạn thêm nhãn vào một thư, nhãn đó sẽ được thêm vào thư đó và được liên kết với chuỗi thư mà thư đó thuộc về. Nhãn này sẽ không được thêm vào các thư khác trong chuỗi thư.
Nếu bạn xoá nhãn khỏi một thư và thư đó là thư duy nhất trong chuỗi có nhãn đó, thì nhãn cũng sẽ bị xoá khỏi chuỗi.
Để thêm hoặc xoá nhãn được áp dụng cho một thư, hãy sử dụng messages.modify.