Tài liệu này giải thích cách quản lý nhãn trên các chuỗi và thư bằng Gmail API.
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ư, đồng thời á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 nguyên labels.
Để quản lý nhãn, bạn phải sử dụng phạm vi https://www.googleapis.com/auth/gmail.labels không nhạy cảm. Để biết thêm thông tin về các phạm vi, hãy xem phần Chọn phạm vi 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ư INBOX. Tên nhãn hệ thống được dành riêng; bạn không thể tạo nhãn USER có tên giống 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ể á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ư:
|
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ư 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ẻ 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 chuỗi tin nhắn và thư
Nhãn chỉ có trên thư. Nếu truy xuất danh sách nhãn trên một chuỗi, bạn sẽ nhận được danh sách nhãn có trên mọi thư trong chuỗi đó. Không phải tin nhắn nào trong một chuỗi cũng có nhãn.
Bạn không thể áp dụng nhãn cho thư nháp.
Thêm hoặc xoá nhãn trên chuỗi tin nhắn
Khi thêm hoặc xoá nhãn trên một chuỗi thư, 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 thư đó.
Nếu thư được thêm vào một chuỗi sau khi bạn thêm nhãn, thì các 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ê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 trên 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 đã áp dụng cho một thư, hãy dùng messages.modify.