חיפוש וסינון של הודעות

במאמר הזה מוסבר איך לשלוח שאילתות ולמצוא הודעות באמצעות Gmail API.

אפשר לחפש או לסנן קבצים באמצעות ה-methods‏ messages.list ו-threads.list. השיטות האלה מקבלות את פרמטר השאילתה q, שתומך ברוב תחביר החיפוש המתקדם כמו בממשק האינטרנט של Gmail. רשימת ההבדלים בין החיפוש והסינון בממשק המשתמש של Gmail לבין Gmail API מופיעה במאמר ההבדלים מממשק המשתמש של Gmail.

תחביר החיפוש המתקדם הזה מאפשר לכם להשתמש בשאילתות כדי לסנן הודעות לפי מאפיינים כמו השולח, התאריך או התווית. לדוגמה, השאילתה הבאה של שיטת messages.list מאחזרת את כל ההודעות שנשלחו על ידי המשתמש בינואר 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

ממשק Gmail API תומך ברוב תחביר החיפוש המתקדם שמשמש בממשק המשתמש של Gmail, אבל יש כמה הבדלים:

  • ממשק המשתמש של Gmail מבצע הרחבת כינוי, שמאפשרת לו להסיק כינוי של חשבון מחשבון Google Workspace. לדוגמה, נניח שיש לכם חשבון myprimary@cymbalgroup.com והאדמין שלכם מגדיר כתובת אימייל חלופית לחשבון הזה: myalias@cymbalgroup.com. אם myalias@cymbalgroup.com שולח אימייל, אבל אתם מחפשים את from: myprimary@cymbalgroup.com, האימייל שנשלח על ידי myalias@cymbalgroup.com מופיע בתוצאות החיפוש בממשק המשתמש של Gmail, אבל לא בתגובת ה-API.

  • ממשק המשתמש של Gmail מאפשר למשתמשים לבצע חיפושים בכל השרשור, אבל ה-API לא מאפשר זאת.