Đang tìm kiếm Tin nhắn

Bạn có thể tìm kiếm hoặc lọc tệp bằng các phương thức messages.list và threads.list. Các phương thức này chấp nhận tham số q hỗ trợ hầu hết các cú pháp tìm kiếm nâng cao giống như giao diện web của Gmail. Để biết danh sách các điểm khác biệt về tính năng tìm kiếm và lọc giữa giao diện người dùng Gmail và API Gmail, hãy xem bài viết Sự khác biệt về bộ lọc tìm kiếm: Giao diện người dùng Gmail so với API Gmail.

Cú pháp nâng cao này cho phép bạn sử dụng cụm từ tìm kiếm để lọc thư theo các thuộc tính như người gửi, ngày hoặc nhãn, v.v. Ví dụ: truy vấn sau đây truy xuất tất cả tin nhắn mà người dùng gửi vào tháng 1 năm 2014:

GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01

Ngoài cụm từ tìm kiếm, bạn cũng có thể lọc tin nhắn và chuỗi tin nhắn theo nhãn bằng tham số labelIds. Thao tác này cho phép bạn tìm kiếm thư và chuỗi thư có nhãn hệ thống hoặc nhãn người dùng được chỉ định. Để biết thêm thông tin, hãy xem tài liệu tham khảo về phương thức messages.list hoặc threads.list.

Điểm khác biệt giữa tính năng tìm kiếm và bộ lọc: Giao diện người dùng Gmail so với API Gmail

  • Giao diện người dùng Gmail thực hiện tính năng mở rộng bí danh, cho phép suy luận một bí danh tài khoản từ tài khoản Google Workspace. Ví dụ: giả sử bạn có một tài khoản là myprimary@mycompany.net và quản trị viên thiết lập bí danh cho tài khoản đó là myalias@mycompany.net. Nếu myalias@mycompany.net gửi email nhưng bạn tìm kiếm "from: myprimary@mycompany.net)", thì email do myalias@mycompany.net gửi sẽ xuất hiện dưới dạng kết quả tìm kiếm trên giao diện người dùng Gmail, nhưng không xuất hiện trong phản hồi API.

  • Giao diện người dùng của Gmail cho phép người dùng tìm kiếm trên toàn chuỗi thư, nhưng API lại không.