Cycle de vie des étiquettes

Les libellés, les champs et les choix passent par des états spécifiques tout au long de leur cycle de vie. De plus, les libellés peuvent avoir des révisions différentes. Le schéma suivant illustre le cycle de vie des libellés, y compris la révision:

1. Créer un libellé (create()) : le libellé est créé et stocké dans une base de données en tant que revision_id=1. L'état du libellé est UNPUBLISHED_DRAFT. Dans cet état :
   • Les utilisateurs ne peuvent pas voir l'étiquette
   • Les utilisateurs ne peuvent pas appliquer le libellé aux éléments Drive.
2. (Facultatif) Mettre à jour un libellé, un champ ou un choix (delta()) : chaque mise à jour, même avant sa publication, est stockée dans une base de données, et la révision du libellé est incrémentée.
3. Publier un libellé (publish()) : l'état du libellé est PUBLISHED et les utilisateurs peuvent l'appliquer. La publication du libellé augmente sa révision.
4. (Facultatif) Modifier un libellé, un champ ou un choix (delta()) : le libellé, le champ ou le choix est mis à jour et stocké dans une base de données en tant que libellé d'ébauche. Le libellé a l'état PUBLISHED, ce qui signifie qu'il existe des modifications provisoires, mais qu'elles ne sont pas disponibles pour les utilisateurs.hasUnpublishedChanges=true Chaque mise à jour incrémente la révision de l'étiquette.
5. (Facultatif) Publier un libellé (publish()) : si disponible, le brouillon le plus récent est publié. Le libellé a l'état PUBLISHED et les utilisateurs peuvent l'appliquer. La publication du libellé augmente sa version.
6. Désactiver un libellé (disable()) : le libellé a l'état DISABLED, même si les utilisateurs peuvent l'appliquer via l'API. Toutefois, un libellé désactivé n'est pas affiché dans une UI, sauf s'il est configuré pour être affiché. L'abandon du libellé augmente sa révision.
7. Activer un libellé (enable()) : le libellé est renvoyé à un état PUBLISHED et les utilisateurs peuvent l'appliquer. La publication du libellé augmente sa révision.
8. Supprimer un libellé (delete()) : le libellé a l'état DELETED et ne peut pas être appliqué. Les libellés supprimés sont finalement supprimés.

Il est important de souligner que chaque mise à jour d'un libellé incrémente la révision du libellé. Si le libellé a déjà été publié, le publier à nouveau après n mises à jour signifie que son numéro de révision publié est la révision + n + 1 nombre de mises à jour successives.