ניהול תוויות

במסמך הזה מוסבר איך לנהל תוויות בשרשורים ובהודעות באמצעות Gmail API.

אתם יכולים להשתמש בתוויות כדי לתייג, לארגן ולסווג הודעות ושרשורים ב-Gmail. התווית היא ביחס של רבים לרבים עם הודעות ושרשורים: אפשר להחיל כמה תוויות על הודעה או שרשור אחד, ולהחיל תווית אחת על כמה הודעות או שרשורים.

מידע על יצירה, קבלת, הצגת רשימה, עדכון או מחיקה של תוויות מופיע במאמר בנושא המשאב labels.

כדי לנהל תוויות, צריך להשתמש בהיקף https://www.googleapis.com/auth/gmail.labels שלא מכיל מידע אישי רגיש. מידע נוסף על היקפי הרשאות זמין במאמר בחירת היקפי הרשאות ל-Gmail API.

סוגי תוויות

יש שני סוגים של תוויות: תוויות שמורות SYSTEM ותוויות בהתאמה אישית USER.

תוויות מערכת בדרך כלל תואמות לרכיבים מוגדרים מראש בממשק האינטרנט של Gmail, כמו INBOX. שמות של תוויות מערכת שמורים, ולכן אי אפשר ליצור תווית 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.