Bạn có thể sử dụng nhãn để gắn thẻ, sắp xếp và phân loại thư và chuỗi thư trong Gmail. Một nhãn có mối quan hệ nhiều với nhiều đối với các thư và luồng: bạn có thể áp dụng nhiều nhãn cho một thư hoặc chuỗi cũng như áp dụng một nhãn cho nhiều thư hoặc chuỗi.
Để biết thông tin về cách tạo, lấy, danh sách, 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ề phạm vi, hãy xem bài viết Thông tin xác thực và uỷ quyền dành riêng cho API Gmail.
Loại nhãn
Nhãn có hai biến: nhãn SYSTEM dành riêng 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 Gmail chẳng hạn như hộp thư đến. Tên nhãn hệ thống đã được đặt trước; không thể tạo nhãn USER có cùng tên với nhãn SYSTEM. Bảng sau đây liệt kê một số nhãn phổ biến nhất của hệ thống Gmail:
| Tên | Có thể áp dụng theo cách thủ công | Ghi chú |
|---|---|---|
INBOX |
có | |
SPAM |
có | |
TRASH |
có | |
UNREAD |
có | |
STARRED |
có | |
IMPORTANT |
có | |
SENT |
no | Được tự động áp dụng cho những thư được gửi bằng drafts.send hoặc messages.send, 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 |
no | Tự động áp dụng cho tất cả thư draft được tạo bằng API Gmail hoặc giao diện Gmail. |
CATEGORY_PERSONAL |
có | Tương ứng với thư hiển thị trong thẻ Cá nhân của giao diện Gmail. |
CATEGORY_SOCIAL |
có | Tương ứng với thư hiển thị trong thẻ Mạng xã hội của giao diện Gmail. |
CATEGORY_PROMOTIONS |
có | Tương ứng với những thư hiển thị trong thẻ Quảng cáo của giao diện Gmail. |
CATEGORY_UPDATES |
có | Tương ứng với các thông báo hiển thị trong thẻ Cập nhật của giao diện Gmail. |
CATEGORY_FORUMS |
có | Tương ứng với các thông báo hiển thị trong thẻ Diễn đàn của giao diện Gmail. |
Quản lý nhãn trên thư và chuỗi
Nhãn chỉ tồn tại trên thư. Ví dụ: nếu liệt kê các nhãn trên một chuỗi, bạn sẽ nhận được danh sách các nhãn có trên bất kỳ thư nào trong chuỗi đó. Nhãn có thể không tồn tại trên mọi thư trong một chuỗi. 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, bạn sẽ thêm hoặc xoá nhãn đã chỉ định trên tất cả các thư hiện có trong chuỗi đó.
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ó liên kết với chuỗi đó. Để thêm nhãn vào các thư đó, hãy thêm lại nhãn vào chuỗi.
Để thêm hoặc xoá các nhãn liên kết với một luồng, hãy sử dụng threads.modify.
Thêm hoặc xoá nhãn cho 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 chứa thư. Nhãn này sẽ không được thêm vào các thư khác trong chuỗi.
Nếu bạn xoá nhãn khỏi một thư và đó 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á các nhãn được áp dụng cho một thư, hãy dùng messages.modify.