קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
תוויות, שדות ובחירות עוברים מצבים ספציפיים במהלך החיים שלהם.
בנוסף, לתוויות יכולות להיות גרסאות שונות. בתרשים הבא מוצג מחזור החיים של התווית, כולל גרסאות:
איור 3. מחזור החיים של תווית
יצירת תווית (create()) – התווית נוצרת ונשמרת במסד נתונים בתור revision_id=1. התווית נמצאת במצב UNPUBLISHED_DRAFT.
במצב הזה:
המשתמשים לא יכולים לראות את התווית
המשתמשים לא יכולים להחיל את התווית על פריטים ב-Drive.
(אופציונלי) מעדכנים תווית, שדה או אפשרות בחירה (delta()) – כל עדכון, גם לפני שהוא מתפרסם, מאוחסן במסד נתונים והגרסה של התווית עולה.
פרסום תווית (publish()) – התווית תהיה במצב PUBLISHED והמשתמשים יוכלו להחיל אותה. פרסום התווית מגדיל את הגרסה שלה.
(אופציונלי) עדכון תווית, שדה או אפשרות בחירה (delta()) – התווית, השדה או האפשרות נשמרים במסד נתונים כטיוטת תווית. התווית תהיה במצב PUBLISHED עם hasUnpublishedChanges=true, כלומר יש שינויים בטיוטה אבל הם לא זמינים למשתמשים. כל עדכון מגדיל את הגרסה של התווית.
(אופציונלי) לפרסם תווית (publish()) – אם יש טיוטה עדכנית, היא תפורסם. התווית תהיה בסטטוס PUBLISHED והמשתמשים יוכלו להחיל אותה. פרסום התווית מגדיל את הגרסה שלה.
השבתת תווית (disable()) – התווית נמצאת במצב DISABLED, אבל המשתמשים יכולים להחיל אותה דרך ה-API. עם זאת, תווית מושבתת לא תוצג בממשק המשתמש, אלא אם תגדירו אותה להצגה. כשמוציאים את התווית משימוש, המערכת מגדילה את הגרסה שלה.
הפעלת תווית (enable()) – התווית חוזרת למצב PUBLISHED והמשתמשים יכולים להחיל אותה. פרסום התווית מגדיל את הגרסה שלה.
מחיקת תווית (delete()) – התווית במצב DELETED ואי אפשר להחיל אותה. תוויות שנמחקות נמחקות בסופו של דבר.
חשוב להדגיש שכל עדכון של תווית מגדיל את הגרסה שלה. אם התווית כבר פורסמה, פרסום שלה שוב אחרי n עדכונים יגרום לכך שמספר הגרסה שיפורסם יהיה מספר הגרסה + n + 1 (מספר העדכונים הרצופים).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-12-21 (שעון UTC)."],[[["Labels, fields, and choices transition through various states such as UNPUBLISHED_DRAFT, PUBLISHED, DISABLED, and DELETED during their lifecycle."],["Labels are initially created in an UNPUBLISHED_DRAFT state and can't be viewed or applied until published."],["Every update to a label, including drafts and publishes, increments its revision number."],["Published labels can be disabled and re-enabled, each action impacting their state and revision."],["Deleting a label renders it unusable and eventually leads to its permanent removal."]]],["Labels have lifecycles involving creation, updates, publishing, disabling, enabling, and deletion. Upon creation, a label is an `UNPUBLISHED_DRAFT` and each update increments its revision number. Publishing transitions it to `PUBLISHED`, enabling user application. Updates to a published label create drafts (`hasUnpublishedChanges=true`) and also increment the revision. Disabling sets the state to `DISABLED`, while enabling returns it to `PUBLISHED`. Deletion changes the state to `DELETED`, and eventually the label is purged. Every label update increments the revision count.\n"]]