Menelusuri Pesan

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 dengan antarmuka web Gmail. Untuk mengetahui 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 menurut 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

Peringatan: Semua tanggal yang digunakan dalam kueri penelusuran ditafsirkan sebagai tengah malam pada tanggal tersebut di zona waktu PST. Untuk menentukan tanggal yang akurat untuk zona waktu lain, teruskan nilai dalam detik:

?q=in:sent after:1388552400 before:1391230800

Selain kueri penelusuran, Anda juga dapat memfilter pesan dan rangkaian pesan menurut label dengan parameter labelIds. Dengan demikian, Anda dapat menelusuri pesan dan rangkaian pesan dengan label sistem atau pengguna yang ditentukan. Untuk informasi selengkapnya, lihat referensi metode messages.list atau threads.list.

Perbedaan penelusuran dan pemfilteran: UI Gmail versus Gmail API

• UI Gmail melakukan ekspansi alias yang memungkinkannya menyimpulkan alias akun dari akun Google Workspace. Misalnya, Anda memiliki akun [e-mail] dan admin menyiapkan alias untuk akun tersebut, yaitu [e-mail]. Jika [e-mail] mengirim email, tetapi Anda menelusuri "from: [e-mail])", email yang dikirim oleh [e-mail] akan muncul sebagai hasil penelusuran di UI Gmail, tetapi tidak di respons API.

• UI Gmail memungkinkan pengguna melakukan penelusuran di seluruh rangkaian pesan, tetapi API tidak.