搜尋訊息

您可以使用 messages.listthreads.list 方法搜尋或篩選檔案。這些方法會接受 q 參數,該參數支援 Gmail 網頁介面支援的大部分進階搜尋語法。如要查看 Gmail UI 和 Gmail API 之間的搜尋和篩選差異,請參閱「搜尋篩選器差異:Gmail UI 與 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.listthreads.list 方法參考資料。

搜尋和篩選功能的差異:Gmail 使用者介面與 Gmail API

  • Gmail UI 會執行別名展開功能,從 Google Workspace 帳戶推斷帳戶別名。舉例來說,假設您有一個 myprimary@mycompany.net 帳戶,而管理員為該帳戶設定了 myalias@mycompany.net 別名。如果 myalias@mycompany.net 傳送電子郵件,但您搜尋「from: myprimary@mycompany.net)」,myalias@mycompany.net 傳送的電子郵件會顯示為 Gmail UI 的搜尋結果,但不會顯示在 API 回應中。

  • Gmail UI 允許使用者執行整個會話搜尋,但 API 不允許。