חיפוש הודעות

אפשר לחפש או לסנן קבצים באמצעות השיטות 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 לא מאפשר זאת.