אפשר לחפש או לסנן קבצים באמצעות השיטות messages.list
ו-threads.list
.
השיטות האלה מקבלות את הפרמטר q
שתומך ברוב התחביר של חיפוש מתקדם כמו ממשק האינטרנט של Gmail. לרשימת ההבדלים בין חיפוש וסינון בממשק המשתמש של Gmail לבין ממשק ה-API של Gmail, תוכלו לקרוא את המאמר הבדלים במסנני החיפוש: ממשק המשתמש של Gmail לעומת ממשק ה-API של Gmail.
התחביר המתקדם הזה מאפשר לכם להשתמש בשאילתות חיפוש כדי לסנן הודעות לפי מאפיינים כמו השולח, התאריך או התווית, ולציין כמה אפשרויות. לדוגמה, השאילתה הבאה מאחזרת את כל ההודעות שהמשתמש שלח בינואר 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
.
הבדלים בחיפוש ובסינון: ממשק המשתמש של Gmail לעומת ממשק ה-API של Gmail
בממשק המשתמש של Gmail יש הרחבת כינוי, שמאפשרת לו להסיק את כתובת החשבון החלופית מחשבון Google Workspace. לדוגמה, נניח שיש לכם חשבון
myprimary@mycompany.net
והאדמין מגדיר כתובת אימייל חלופית לחשבוןmyalias@mycompany.net
. אם קיבלת אימייל מ-myalias@mycompany.net
אבל חיפשת "from: myprimary@mycompany.net)
", האימייל שנשלח על ידיmyalias@mycompany.net
מופיע כתוצאת חיפוש בממשק המשתמש של Gmail, אבל לא בתגובת ה-API.בממשק המשתמש של Gmail המשתמשים יכולים לבצע חיפושים בשרשור, אבל ה-API לא מאפשר זאת.