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 (chỉ là một vài ví dụ). Ví dụ: truy vấn sau đây 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 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à 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 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ó một tài khoản myprimary@mycompany.net và quản trị viên thiết lập một biệt hiệu 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 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.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-31 UTC."],[],[],null,["# Searching for Messages\n\nYou can search or filter files using the\n[`messages.list`](/workspace/gmail/api/v1/reference/users/messages/list) and\n[`threads.list`](/workspace/gmail/api/v1/reference/users/threads/list) methods.\nThese methods accept the `q` parameter which supports most of the same\n[advanced search syntax](https://support.google.com/mail/answer/7190) as\nthe Gmail web-interface. For a list of search and filter differences between\nthe Gmail UI and Gmail API, see\n[Search filter differences: Gmail UI versus Gmail API](#differences).\n\nThis advanced syntax allows you to use search queries\nto filter messages by properties such as the sender, date, or label to name a\nfew possibilities. For example, the following query retrieves all messages sent\nby the user in January of 2014: \n\n GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01\n\n| **Warning:** All dates used in the search query are interpreted as midnight on that date in the PST timezone. To specify accurate dates for other timezones pass the value in seconds instead: \n|\n| ```\n| ?q=in:sent after:1388552400 before:1391230800\n| ```\n\nIn addition to search queries, you can also filter messages and threads by label\nwith the `labelIds` parameter. This allows you to search for messages and\nthreads with the specified system or user labels applied. For more information,\nsee the [`messages.list`](/workspace/gmail/api/v1/reference/users/messages/list) or\n[`threads.list`](/workspace/gmail/api/v1/reference/users/threads/list) method reference.\n\nSearch and filter differences: Gmail UI versus Gmail API\n--------------------------------------------------------\n\n- The Gmail UI performs *alias expansion* which allows it to infer an\n account alias from a Google Workspace account. For example, suppose you have an\n account\n of `myprimary@mycompany.net` and your admin sets up an alias for that account of\n `myalias@mycompany.net`. If `myalias@mycompany.net` sends an email, but you\n search for \"`from: myprimary@mycompany.net)`\" the email sent by\n `myalias@mycompany.net` shows up as a search result the Gmail UI, but not in\n the API response.\n\n- The Gmail UI allows users to perform thread-wide searches, but the API\n doesn't."]]
