חיפוש הודעות

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