Tài liệu này giải thích cách truy vấn và tìm thư bằng API Gmail.
Bạn có thể tìm kiếm hoặc lọc tệp bằng cách sử dụ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ố truy vấn q, hỗ trợ hầu hết cú pháp tìm kiếm nâng cao tương tự như giao diện web của Gmail. Để xem 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 phần Điểm khác biệt so với giao diện người dùng Gmail.
Cú pháp tìm kiếm 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. Ví dụ: truy vấn phương thức messages.list sau đây sẽ truy xuất tất cả thư do 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[]. Nhờ đó, bạn có thể 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 các phương thức messages.list và threads.list. Để biết thêm thông tin về nhãn, hãy xem bài viết Quản lý nhãn.
Điểm khác biệt so với giao diện người dùng của Gmail
Mặc dù API Gmail hỗ trợ hầu hết cú pháp tìm kiếm nâng cao được dùng trong giao diện người dùng Gmail, nhưng vẫn có một số điểm khác biệt:
Giao diện người dùng Gmail thực hiện thao tác mở rộng email đại diện, cho phép giao diện này suy luận email đại diện của 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@cymbalgroup.comvà quản trị viên của bạn thiết lập một biệt hiệu cho tài khoản đó làmyalias@cymbalgroup.com. Nếumyalias@cymbalgroup.comgửi email nhưng bạn tìm kiếm "from: myprimary@cymbalgroup.com", thì email domyalias@cymbalgroup.comgửi sẽ xuất hiện trong kết quả tìm kiếm trong 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 Gmail cho phép người dùng thực hiện tìm kiếm trên toàn bộ chuỗi, nhưng API thì không.