Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Labels, Felder und Auswahlmöglichkeiten durchlaufen im Laufe ihres Lebens bestimmte Status.
Außerdem können Labels unterschiedliche Überarbeitungen haben. Das folgende Diagramm zeigt den Label-Lebenszyklus, einschließlich der Überarbeitung:
Abbildung 3: Lebenszyklus eines Labels
Label erstellen (create()): Das Label wird erstellt und in einer Datenbank als revision_id=1 gespeichert. Das Label hat den Status UNPUBLISHED_DRAFT.
In diesem Fall:
Nutzer können das Label nicht sehen
Nutzer können das Label nicht auf Drive-Elemente anwenden.
(Optional) Label, Feld oder Auswahl aktualisieren (delta()): Jede Aktualisierung, auch bevor sie veröffentlicht wird, wird in einer Datenbank gespeichert und die Revision des Labels wird erhöht.
Label veröffentlichen (publish()): Das Label hat den Status PUBLISHED und Nutzer können es anwenden. Wenn Sie das Label veröffentlichen, wird seine Überarbeitung erhöht.
(Optional) Label, Feld oder Auswahl aktualisieren (delta()): Das Label, Feld oder die Auswahl wird aktualisiert und als Entwurf in einer Datenbank gespeichert. Das Label hat den Status PUBLISHED mit hasUnpublishedChanges=true. Das bedeutet, dass es Änderungen am Entwurf gibt, die Nutzern jedoch nicht zur Verfügung stehen. Bei jeder Aktualisierung wird die Überarbeitung des Labels erhöht.
(Optional) Label veröffentlichen (publish()): Wenn verfügbar, wird der aktuelle Entwurf veröffentlicht. Das Label hat den Status PUBLISHED und Nutzer können es anwenden. Wenn Sie das Label veröffentlichen, wird seine Version erhöht.
Label deaktivieren (disable()): Das Label hat den Status DISABLED. Nutzer können das Label jedoch über die API anwenden. Ein deaktiviertes Label wird jedoch nur dann in einer Benutzeroberfläche angezeigt, wenn es entsprechend konfiguriert ist. Wenn Sie das Label einstellen, wird die Revision erhöht.
Label aktivieren (enable()): Das Label wird in den Status PUBLISHED zurückgesetzt und Nutzer können es anwenden. Wenn Sie das Label veröffentlichen, wird seine Überarbeitung erhöht.
Label löschen (delete()): Das Label hat den Status DELETED und kann nicht angewendet werden. Gelöschte Labels werden nach einer gewissen Zeit endgültig entfernt.
Wichtig: Bei jeder Aktualisierung eines Labels wird die Revision des Labels erhöht. Wenn das Label bereits veröffentlicht wurde, wird durch erneutes Veröffentlichen nach n Aktualisierungen die veröffentlichte Revisionsnummer auf Revision + n + 1 aufeinanderfolgende Aktualisierungen erhöht.
[null,null,["Zuletzt aktualisiert: 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."]]
