การค้นหาข้อความ

คุณจะค้นหาหรือกรองไฟล์โดยใช้เมธอดของ 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 แต่ไม่ใช่ในการตอบกลับของ API

  • UI ของ Gmail อนุญาตให้ผู้ใช้ค้นหาแบบชุดข้อความได้ แต่ API ไม่สามารถทำได้