लेबल का लाइफ़साइकल

लेबल, फ़ील्ड, और चुने गए विकल्पों का जीवनभर खास स्थितियों से गुज़रता है. इसके अलावा, लेबल में अलग-अलग बदलाव हो सकते हैं. इस डायग्राम में, लेबल का लाइफ़साइकल दिखाया गया है. इसमें बदलाव भी शामिल हैं:

लेबल के लाइफ़साइकल का डायग्राम.
तीसरी इमेज. लेबल का लाइफ़साइकल
  1. लेबल बनाएं (create())—यह लेबल, डेटाबेस में revision_id=1 के तौर पर बनाया और सेव किया जाता है. लेबल की स्थिति UNPUBLISHED_DRAFT है. इस स्टेटस में:
    • उपयोगकर्ता यह लेबल नहीं देख सकते
    • उपयोगकर्ता, इस लेबल को Drive में मौजूद आइटम पर लागू नहीं कर सकते.
  2. (ज़रूरी नहीं) कोई लेबल, फ़ील्ड या विकल्प अपडेट करें (delta())— हर अपडेट, पब्लिश होने से पहले, डेटाबेस में सेव किया जाता है. और लेबल में किए गए बदलाव को बढ़ाया जाता है.
  3. लेबल पब्लिश करें (publish())—लेबल की स्थिति PUBLISHED होती है और उपयोगकर्ता इस लेबल को लागू कर सकते हैं. लेबल को पब्लिश करने से इसके बदलाव बढ़ जाते हैं.
  4. (ज़रूरी नहीं) लेबल, फ़ील्ड या विकल्प (delta()) को अपडेट करें— लेबल, फ़ील्ड या विकल्प को अपडेट किया जाता है और डेटाबेस में ड्राफ़्ट लेबल के तौर पर सेव किया जाता है. लेबल में hasUnpublishedChanges=true के साथ PUBLISHED की स्थिति है, जिसका मतलब है कि ड्राफ़्ट में बदलाव किए गए हैं, लेकिन ये उपयोगकर्ताओं के लिए उपलब्ध नहीं हैं. हर अपडेट से लेबल का बदलाव बढ़ता है.
  5. (ज़रूरी नहीं) लेबल पब्लिश करें (publish())—अगर उपलब्ध हो, तो सबसे नया ड्राफ़्ट पब्लिश किया जाता है. लेबल की स्थिति PUBLISHED है और उपयोगकर्ता इस लेबल को लागू कर सकते हैं. लेबल को पब्लिश करने पर उसका वर्शन बढ़ जाता है.
  6. लेबल बंद करें (disable())—लेबल की स्थिति DISABLED है. हालांकि, उपयोगकर्ता, एपीआई से लेबल को लागू कर सकते हैं. हालांकि, यूज़र इंटरफ़ेस (यूआई) में बंद किया गया कोई लेबल तब तक नहीं दिखता, जब तक कि दिखाने के लिए कॉन्फ़िगर न किया गया हो. लेबल को रोकने से इसका बदलाव बढ़ता है.
  7. लेबल चालू करें (enable())—लेबल को PUBLISHED स्थिति में वापस भेज दिया जाता है और उपयोगकर्ता उस लेबल को लागू कर सकते हैं. लेबल को पब्लिश करने से इसके बदलाव बढ़ जाते हैं.
  8. लेबल मिटाएं (delete())—लेबल की स्थिति DELETED है और इसे लागू नहीं किया जा सकता. मिटाए गए लेबल पूरी तरह मिट जाते हैं.

इस बात पर ज़ोर देना ज़रूरी है कि लेबल में किए जाने वाले हर अपडेट से लेबल के बदलाव में बढ़ोतरी होती है. साथ ही, अगर लेबल को पहले ही पब्लिश किया जा चुका है, तो उसे n अपडेट के बाद फिर से पब्लिश करने का मतलब है कि इसका पब्लिश किया गया बदलाव नंबर, बदलाव + n + 1 एक के बाद किए जाने वाले अपडेट की संख्या है.