您可以使用 messages.list 和 threads.list 方法搜尋或篩選檔案。這些方法會接受 q 參數，該參數支援與 Gmail 網頁介面相同的進階搜尋語法。如要查看 Gmail 使用者介面和 Gmail API 的搜尋與篩選差異清單，請參閱「搜尋篩選條件差異：Gmail 使用者介面與 Gmail API」。
您可以使用這項進階語法，透過搜尋查詢依寄件者、日期或標籤等屬性篩選郵件。舉例來說，下列查詢會擷取使用者在 2014 年 1 月傳送的所有訊息：
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
除了搜尋查詢外，您也可以使用 labelIds 參數，依標籤篩選郵件和郵件串。這樣一來，您就能搜尋套用指定系統或使用者標籤的郵件和討論串。詳情請參閱 messages.list 或 threads.list 方法參考資料。
搜尋和篩選差異：Gmail 使用者介面與 Gmail API
Gmail 使用者介面會執行別名擴展，從 Google Workspace 帳戶推斷帳戶別名。舉例來說，假設您的帳戶是
myprimary@mycompany.net，而管理員為該帳戶設定的別名是myalias@mycompany.net。如果myalias@mycompany.net傳送電子郵件，但您搜尋「from: myprimary@mycompany.net)」，Gmail 使用者介面會將myalias@mycompany.net傳送的電子郵件顯示為搜尋結果，但 API 回應不會。Gmail UI 可讓使用者執行整個郵件串的搜尋，但 API 不支援這項功能。