אתם יכולים להשתמש בתוויות כדי לתייג, לארגן ולסיווג הודעות וסוגיות ב-Gmail. לתוויות יש קשר מסוג 'רבים לרבים' עם הודעות שרשור: אפשר להחיל כמה תוויות על הודעה או שרשור יחידים, ולהחיל תווית אחת על כמה הודעות או שרשור.
במאמר מידע על תוויות מוסבר איך create, לקבל, לסקור, לעדכן או למחוק תוויות.
כדי לנהל תוויות, צריך להשתמש בהיקף 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 |
לא | המערכת מחילה את התג הזה באופן אוטומטי על כל ההודעות ב-draft שנוצרו באמצעות Gmail API או ממשק Gmail. |
CATEGORY_PERSONAL |
כן | תואמות להודעות שמוצגות בכרטיסייה 'אישי' בממשק Gmail. |
CATEGORY_SOCIAL |
כן | תואמת להודעות שמוצגות בכרטיסייה 'רשתות חברתיות' בממשק Gmail. |
CATEGORY_PROMOTIONS |
כן | תואמת להודעות שמוצגות בכרטיסייה 'קידומי מכירות' בממשק Gmail. |
CATEGORY_UPDATES |
כן | תואמות להודעות שמוצגות בכרטיסייה 'עדכונים' בממשק של Gmail. |
CATEGORY_FORUMS |
כן | תואמת להודעות שמוצגות בכרטיסייה 'פורומים' בממשק של Gmail. |
ניהול תוויות בהודעות ובשרשורים
תוויות קיימות רק בהודעות. לדוגמה, אם תציגו רשימה של תוויות בשרשור, תקבלו רשימה של התוויות שקיימות בכל אחת מההודעות בשרשור. יכול להיות שלא תהיה תווית לכל הודעה בשרשור. אפשר להחיל כמה תוויות על הודעות, אבל אי אפשר להחיל תוויות על טיוטות של הודעות.
הוספה או הסרה של תוויות לשרשור
כשמוסיפים או מסירים תווית לשרשור, התווית הזו מתווספת או מוסרת מכל ההודעות הקיימות בשרשור.
אם מוסיפים הודעות לשרשור אחרי שמוסיפים לו תווית, ההודעות החדשות לא יורשות את התווית הקיימת שמשויכת לשרשור. כדי להוסיף את התווית להודעות האלה, צריך להוסיף אותה שוב לשרשור.
כדי להוסיף או להסיר תוויות שמשויכות לשרשור, משתמשים בthreads.modify.
הוספה או הסרה של תוויות להודעות
כשמוסיפים תווית להודעה, היא מתווספת להודעה הזו ומשויכת לשרשור שאליו ההודעה שייכת. התווית לא תתווסף להודעות אחרות בשרשור.
אם תסירו תווית מהודעה והיא הייתה ההודעה היחידה בשרשור עם התווית הזו, התווית תוסר גם מהשרשור.
כדי להוסיף או להסיר תוויות שהוחלו על הודעה, משתמשים בmessages.modify.