תווית מחזור החיים

תוויות, שדות ואפשרויות עוברים מצבים ספציפיים במהלך החיים שלהם. בנוסף, יכול להיות שלתוויות יהיו גרסאות שונות. בתרשים הבא מוצג מחזור החיים של התווית, כולל ניהול גרסאות:

1. יצירת תווית (create()) – התווית נוצרת ונשמרת במסד נתונים בתור revision_id=1. התווית במצב UNPUBLISHED_DRAFT. במצב הזה:
   • המשתמשים לא יכולים לראות את התווית
   • המשתמשים לא יכולים להחיל את התווית על פריטים ב-Drive.
2. (אופציונלי) מעדכנים תווית, שדה או בחירה (delta()) – כל עדכון, גם לפני שהוא מתפרסם, נשמר במסד נתונים, והמספר של הגרסה של התווית גדל.
3. פרסום תווית (publish()) – התווית במצב PUBLISHED והמשתמשים יכולים להחיל את התווית. פרסום התווית מגדיל את מספר הגרסה שלה.
4. (אופציונלי) עדכון תווית, שדה או בחירה (delta()) – התווית, השדה או הבחירה מתעדכנים ונשמרים במסד נתונים כתווית טיוטה. התווית כוללת את המצב PUBLISHED עם hasUnpublishedChanges=true, כלומר יש שינויים בטיוטה, אבל הם לא זמינים למשתמשים. כל עדכון מגדיל את מספר הגרסה של התווית.
5. (אופציונלי) פרסום תווית (publish()) – אם יש טיוטה, היא תפורסם. התווית במצב PUBLISHED והמשתמשים יכולים להחיל אותה. כשמפרסמים את התווית, הגרסה שלה מתעדכנת.
6. השבתת תווית (disable()) – התווית במצב DISABLED, אבל המשתמשים יכולים להוסיף את התווית דרך ה-API. עם זאת, תווית מושבתת לא מוצגת בממשק משתמש אלא אם היא מוגדרת להצגה. הוצאה משימוש של התווית מגדילה את מספר הגרסה שלה.
7. הפעלת תווית (enable()) – התווית חוזרת למצב PUBLISHED והמשתמשים יכולים להחיל אותה. פרסום התווית מגדיל את מספר הגרסה שלה.
8. מחיקת תווית (delete()) – התווית במצב DELETED ואי אפשר להחיל אותה. תוויות שנמחקו נמחקות באופן סופי.

חשוב להדגיש שכל עדכון של תווית מגדיל את מספר הגרסה של התווית. בנוסף, אם התווית כבר פורסמה, פרסום חוזר שלה אחרי n עדכונים פירושו שמספר הגרסה שפורסמה הוא גרסה + n + 1 מספר העדכונים הרצופים.