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

Bạn có thể tìm kiếm hoặc lọc các tệp bằng 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ú pháp tìm kiếm nâng cao giống như giao diện web Gmail. Để biết danh sách những điểm khác biệt về cách tìm kiếm và bộ lọc giữa giao diện người dùng Gmail và API Gmail, hãy xem phần Sự khác biệt về bộ lọc tìm kiếm: Giao diện người dùng Gmail và API Gmail.

Cú pháp nâng cao này cho phép bạn sử dụng các 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 để đặt tên cho một số khả năng. Ví dụ: truy vấn sau đây truy xuất tất cả các thông báo do người dùng gửi trong 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ác cụm từ tìm kiếm, bạn cũng có thể lọc thư và chuỗi theo nhãn bằng tham số labelIds. Thao tác này cho phép bạn tìm kiếm tin nhắn và chuỗi được áp dụng nhãn hệ thống hoặc nhãn người dùng đã 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.

Sự khác biệt về tìm kiếm và bộ lọc: Giao diện người dùng của 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 email đại diện để suy ra bí danh tài khoản từ một tài khoản Google Workspace. Ví dụ: giả sử bạn có tài khoản myprimary@mycompany.net và quản trị viên của bạn thiết lập một email đại diện cho tài khoản 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 của Gmail, nhưng không xuất hiện trong phản hồi của API.

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