Bạn có thể sử 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 với nhiều với thư và luồng: bạn có thể áp dụng nhiều nhãn cho một thư hoặc luồng và áp dụng một nhãn cho nhiều thư hoặc luồng.
Để biết thông tin về cách create, 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ề phạm vi, hãy xem thông tin xác thực và uỷ quyền dành riêng cho API Gmail.
Các loại nhãn
Có hai loại nhãn: 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 được đặt trước; không thể tạo nhãn USER có tên giống với nhãn SYSTEM. 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ể á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 | Được tự động áp dụng cho các 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 thông qua giao diện web. |
DRAFT |
không | Tự động áp dụng cho tất cả các tin nhắn 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 các 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 các 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ẻ Nội dung cập nhật của giao diện Gmail. |
CATEGORY_FORUMS |
có | Tương ứng với các thư 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 thư
Nhãn chỉ tồn tại trên thư. Ví dụ: nếu liệt kê nhãn trên một chuỗi tin nhắn, bạn sẽ nhận được danh sách nhãn tồn tại trên bất kỳ tin nhắn nào trong chuỗi tin nhắn đó. Một nhãn có thể không tồn tại trên mọi tin nhắn trong một chuỗi tin 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 cho chuỗi thư
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 trên tất cả thư hiện có trong chuỗi thư đó.
Nếu thư được thêm vào một chuỗi thư 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ư đó. Để thêm nhãn vào các 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 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à liên kết với chuỗi thư mà thư đó thuộc về. Nhãn này 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à đó là thư duy nhất trong chuỗi thư có nhãn đó, thì nhãn đó cũng sẽ bị xoá khỏi chuỗi thư.
Để thêm hoặc xoá nhãn được áp dụng cho một tin nhắn, hãy sử dụng messages.modify.