אתם יכולים להשתמש בתוויות כדי לתייג, לארגן ולסווג הודעות ושרשורים ב-Gmail. הקשר בין תוויות לבין הודעות ושרשורים הוא מסוג 'רבים לרבים': אפשר להחיל כמה תוויות על הודעה או על שרשור אחד, ואפשר להחיל תוויות אחת על כמה הודעות או שרשורים.
מידע על יצירה, קבלת, הצגת רשימה, עדכון או מחיקה של תוויות מופיע במאמר הפניה לתוויות.
כדי לנהל תוויות, צריך להשתמש בהיקף https://www.googleapis.com/auth/gmail.labels. מידע נוסף על היקפי הרשאות זמין במאמר בנושא הרשאה ואימות ספציפיים ל-Gmail API.
סוגי תוויות
יש שני סוגים של תוויות: תוויות שמורות SYSTEM ותוויות מותאמות אישית USER.
תוויות מערכת בדרך כלל תואמות לרכיבים מוגדרים מראש בממשק האינטרנט של Gmail, כמו תיבת הדואר הנכנס. השמות של תוויות המערכת שמורים, ואי אפשר ליצור תוויות USER עם שם זהה לשם של תוויות SYSTEM. בטבלה הבאה מפורטות כמה מהתוויות הנפוצות ביותר של מערכת Gmail:
| שם | אפשר להחיל אותם באופן ידני | הערות |
|---|---|---|
INBOX |
כן | |
SPAM |
כן | |
TRASH |
כן | |
UNREAD |
כן | |
STARRED |
כן | |
IMPORTANT |
כן | |
SENT |
לא | התווית מוחלת באופן אוטומטי על הודעות שנשלחות עם
drafts.send או
messages.send, מוכנסת
עם messages.insert
וכתובת האימייל של המשתמש בכותרת From, או שנשלחות על ידי המשתמש דרך
ממשק האינטרנט. |
DRAFT |
לא | התוויות מוחלות באופן אוטומטי על כל ההודעות שנוצרו באמצעות Gmail API או ממשק Gmail.draft |
CATEGORY_PERSONAL |
כן | מתייחס להודעות שמוצגות בכרטיסייה 'אישי' בממשק של Gmail. |
CATEGORY_SOCIAL |
כן | מתאים להודעות שמוצגות בכרטיסייה 'רשתות חברתיות' בממשק Gmail. |
CATEGORY_PROMOTIONS |
כן | מתאים להודעות שמוצגות בכרטיסייה 'קידומי מכירות' בממשק Gmail. |
CATEGORY_UPDATES |
כן | מתאים להודעות שמוצגות בכרטיסייה 'עדכונים' בממשק של Gmail. |
CATEGORY_FORUMS |
כן | מתאים להודעות שמוצגות בכרטיסייה 'פורומים' בממשק של Gmail. |
ניהול תוויות בהודעות ובשרשורים
תוויות קיימות רק בהודעות. לדוגמה, אם מציגים את התוויות בשרשור, מקבלים רשימה של תוויות שקיימות בכל אחת מההודעות בשרשור. יכול להיות שתווית מסוימת לא תופיע בכל ההודעות בשרשור. אפשר להחיל כמה תוויות על הודעות, אבל אי אפשר להחיל תוויות על הודעות בטיוטה.
הוספה או הסרה של תוויות לשרשורים
כשמוסיפים או מסירים תווית לשרשור, התווית שצוינה מתווספת לכל ההודעות הקיימות בשרשור או מוסרת מהן.
אם מוסיפים הודעות לשרשור אחרי שמוסיפים לו תווית, התווית הקיימת שמשויכת לשרשור לא משויכת גם להודעות החדשות. כדי להוסיף את התווית להודעות האלה, מוסיפים את התווית לשרשור שוב.
כדי להוסיף או להסיר תוויות שמשויכות לשרשור, משתמשים בפקודה threads.modify.
הוספה או הסרה של תוויות להודעות
כשמוסיפים תווית להודעה, התווית מתווספת להודעה ומשויכת לשרשור שההודעה שייכת אליו. התווית לא מתווספת להודעות אחרות בשרשור.
אם תסירו תווית מהודעה והיא הייתה ההודעה היחידה בשרשור עם התווית הזו, התווית תוסר גם מהשרשור.
כדי להוסיף או להסיר תוויות שחלות על הודעה, משתמשים ב-messages.modify.