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

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