คุณจะค้นหาหรือกรองไฟล์โดยใช้เมธอดของ messages.list
และ threads.list
ได้
วิธีการเหล่านี้จะยอมรับพารามิเตอร์ q
ซึ่งรองรับไวยากรณ์การค้นหาขั้นสูงส่วนใหญ่เช่นเดียวกับอินเทอร์เฟซบนเว็บของ Gmail ดูรายการความแตกต่างของการค้นหาและตัวกรองระหว่าง UI ของ Gmail กับ Gmail API ได้ที่ความแตกต่างของตัวกรองการค้นหา: UI ของ Gmail กับ Gmail API
ไวยากรณ์ขั้นสูงนี้ทำให้คุณสามารถใช้คำค้นหาเพื่อกรองข้อความตามคุณสมบัติ เช่น ผู้ส่ง วันที่ หรือป้ายกำกับ เพื่อจำแนกที่เป็นไปได้ ตัวอย่างเช่น การค้นหาต่อไปนี้จะเรียกข้อความทั้งหมดที่ผู้ใช้ส่งในเดือนมกราคม 2014
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
ความแตกต่างระหว่างการค้นหาและตัวกรอง: UI ของ Gmail เทียบกับ Gmail API
UI ของ Gmail ดำเนินการขยายชื่อแทน ซึ่งช่วยให้สามารถอนุมานชื่อแทนบัญชีจากบัญชี Google Workspace ได้ ตัวอย่างเช่น สมมติว่าคุณมีบัญชี
myprimary@mycompany.net
และผู้ดูแลระบบตั้งค่าชื่อแทนสำหรับบัญชีดังกล่าวของmyalias@mycompany.net
หากmyalias@mycompany.net
ส่งอีเมล แต่คุณค้นหา "from: myprimary@mycompany.net)
" อีเมลที่ส่งจากmyalias@mycompany.net
จะแสดงเป็นผลการค้นหา UI ของ Gmail แต่ไม่ใช่ในการตอบกลับของ APIUI ของ Gmail อนุญาตให้ผู้ใช้ค้นหาแบบชุดข้อความได้ แต่ API ไม่สามารถทำได้