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