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 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 menurut label dengan parameter labelIds. Dengan demikian, Anda dapat menelusuri pesan dan rangkaian pesan dengan label sistem atau pengguna tertentu yang diterapkan. Untuk informasi selengkapnya, lihat referensi metode messages.list atau threads.list.

Perbedaan penelusuran dan pemfilteran: 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.net dan admin Anda menyiapkan alias untuk akun tersebut, yaitu myalias@mycompany.net. Jika myalias@mycompany.net mengirim email, tetapi Anda menelusuri "from: myprimary@mycompany.net)", email yang dikirim oleh myalias@mycompany.net 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 memungkinkannya.