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

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