Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 différentes révisions. Le schéma suivant illustre le cycle de vie des libellés, y compris la révision :
Figure 3. Cycle de vie d'un libellé
Créer un libellé (create()) : le libellé est créé et stocké dans une base de données sous la forme revision_id=1. L'état du libellé est UNPUBLISHED_DRAFT.
Dans cet état :
Les utilisateurs ne peuvent pas voir le libellé
Les utilisateurs ne peuvent pas appliquer le libellé aux éléments Drive.
(Facultatif) Mettez à jour un libellé, un champ ou un choix (delta()) : chaque modification, même avant sa publication, est stockée dans une base de données, et la révision du libellé est incrémentée.
Publier un libellé (publish()) : le libellé est à l'état PUBLISHED et les utilisateurs peuvent l'appliquer. La publication du libellé incrémente sa révision.
(Facultatif) Mettez à jour un libellé, un champ ou un choix (delta()) : le libellé, le champ ou le choix sont mis à jour et stockés dans une base de données en tant que libellé brouillon. Le libellé est à l'état PUBLISHED avec hasUnpublishedChanges=true, ce qui signifie qu'il existe des modifications en brouillon, mais qu'elles ne sont pas disponibles pour les utilisateurs. Chaque mise à jour incrémente la révision du libellé.
(Facultatif) Publier un libellé (publish()) : si disponible, le brouillon le plus récent est publié. Le libellé est à l'état PUBLISHED et les utilisateurs peuvent l'appliquer. La publication du libellé incrémente sa version.
Désactiver un libellé (disable()) : le libellé est à l'état DISABLED, mais les utilisateurs peuvent l'appliquer via l'API. Toutefois, un libellé désactivé ne s'affiche pas dans une UI, sauf s'il est configuré pour s'afficher. La suppression du libellé incrémente sa révision.
Activer un libellé (enable()) : le libellé revient à l'état PUBLISHED et les utilisateurs peuvent l'appliquer. La publication du libellé incrémente sa révision.
Supprimer un libellé (delete()) : le libellé est à l'état DELETED et ne peut pas être appliqué. Les libellés supprimés finissent par être purgés.
Il est important de souligner que chaque modification apportée à un libellé incrémente sa révision. 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 égal à la révision + n + 1, où n correspond au nombre de mises à jour successives.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Label lifecycle\n\nLabels, fields, and choices go through specific states throughout their lives.\nAdditionally, labels might have different revisions. The following diagram shows\nthe label lifecycle, including revisioning:\n**Figure 3.** Lifecycle of a label\n\n1. **Create a label (`create()`)** ---The label is created and stored in a database as `revision_id=1`. The label has the state of `UNPUBLISHED_DRAFT`. In this state:\n - Users can't view the label\n - Users can't apply the label to Drive items.\n2. **(optional) Update a label, field, or choice (`delta()`)**--- Every update, even before it's published, is stored in a database, and the label's revision is incremented.\n3. **Publish a label (`publish()`)** ---The label has the state of `PUBLISHED` and users can apply the label. Publishing the label increments its revision.\n4. **(optional) Update a label, field, or choice (`delta()`)** --- The label, field, or choice is updated and stored in a database as a draft label. The label has the state of `PUBLISHED` with `hasUnpublishedChanges=true` meaning there are draft changes, but they aren't available to users. Each update increments the label's revision.\n5. **(optional) Publish a label (`publish()`)** ---If available, the most-current draft is published. The label has the state of `PUBLISHED` and users can apply the label. Publishing the label increments its version.\n6. **Disable a label (`disable()`)** ---The label has the state of `DISABLED` though users can apply the label through the API. However, a disabled label isn't shown in a UI unless configured to be shown. Deprecating the label increments its revision.\n7. **Enable a label (`enable()`)** ---The label is returned to a `PUBLISHED` state and users can apply the label. Publishing the label increments its revision.\n8. **Delete a label (`delete()`)** ---The label has a state of `DELETED` and can't be applied. Deleted labels are eventually purged.\n\nIt's important to emphasize that every update to a label increments the label's\nrevision. And, if the label has already been published, publishing it again\nafter *n* updates means that its published revision number is revision + *n* + 1\nnumber of successive updates."]]
