Anda dapat menelusuri atau memfilter file menggunakan metode
messages.list dan
threads.list.
Metode ini menerima parameter q yang mendukung sebagian besar sintaksis penelusuran lanjutan yang sama seperti antarmuka web Gmail. Untuk daftar perbedaan penelusuran dan filter antara
UI Gmail dan Gmail API, lihat
Perbedaan filter penelusuran: UI Gmail versus Gmail API.
Sintaksis lanjutan ini memungkinkan Anda menggunakan kueri penelusuran untuk memfilter pesan berdasarkan properti seperti pengirim, tanggal, atau label untuk menyebutkan beberapa kemungkinan. Misalnya, kueri berikut mengambil semua pesan yang dikirim oleh pengguna pada Januari 2014:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
Selain kueri penelusuran, Anda juga dapat memfilter pesan dan rangkaian pesan berdasarkan label dengan parameter labelIds. Hal ini memungkinkan Anda menelusuri pesan dan thread dengan menerapkan label sistem atau pengguna yang ditentukan. Untuk informasi selengkapnya,
lihat referensi metode messages.list atau
threads.list.
Perbedaan penelusuran dan filter: UI Gmail versus Gmail API
UI Gmail melakukan perluasan alias yang memungkinkannya menyimpulkan alias akun dari akun Google Workspace. Misalnya, Anda memiliki akun
myprimary@mycompany.netdan admin Anda menyiapkan alias untuk akunmyalias@mycompany.nettersebut. Jikamyalias@mycompany.netmengirim email, tetapi Anda menelusuri "from: myprimary@mycompany.net)", email yang dikirim olehmyalias@mycompany.netakan muncul sebagai hasil penelusuran, UI Gmail, tetapi tidak dalam respons API.UI Gmail memungkinkan pengguna melakukan penelusuran di seluruh thread, tetapi API tidak.