חיפוש הודעות

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

ההבדלים בין חיפוש וסינון: ממשק המשתמש של Gmail לעומת Gmail API

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

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