Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Метки, поля и варианты выбора проходят определённые состояния на протяжении своего жизненного цикла. Кроме того, метки могут иметь различные версии. На следующей диаграмме показан жизненный цикл метки, включая версии:
Рисунок 3. Жизненный цикл этикетки
Создание метки ( create() ) — метка создаётся и сохраняется в базе данных как revision_id=1 . Метка имеет состояние UNPUBLISHED_DRAFT . В этом состоянии:
Пользователи не могут просматривать этикетку
Пользователи не могут применять метку к элементам Диска.
(необязательно) Обновите метку, поле или выбор ( delta() ) — каждое обновление, даже до его публикации, сохраняется в базе данных, а номер версии метки увеличивается.
Публикация метки ( publish() ) — метка имеет статус PUBLISHED , и пользователи могут её применять. Публикация метки увеличивает её номер версии.
(необязательно) Обновить метку, поле или вариант ( delta() ) — метка, поле или вариант обновляются и сохраняются в базе данных как черновик метки. Метка имеет статус PUBLISHED с hasUnpublishedChanges=true что означает наличие черновиков изменений, но они недоступны пользователям. Каждое обновление увеличивает номер версии метки.
(необязательно) Опубликовать метку ( publish() ) — если доступно, публикуется самый последний черновик. Метка имеет статус PUBLISHED , и пользователи могут её применить. Публикация метки увеличивает её версию.
Отключение метки ( disable() ) — метка имеет состояние DISABLED , хотя пользователи могут применить её через API. Однако отключённая метка не отображается в пользовательском интерфейсе, если не настроено её отображение. Отмена метки увеличивает её версию.
Включить метку ( enable() ) — метка возвращается в состояние PUBLISHED , и пользователи могут её применить. Публикация метки увеличивает её номер версии.
Удалить метку ( delete() ) — метка имеет статус DELETED и не может быть применена. Удалённые метки в конечном итоге очищаются.
Важно подчеркнуть, что каждое обновление метки увеличивает её номер версии. И если метка уже была опубликована, её повторная публикация после n обновлений означает, что номер опубликованной версии равен номеру версии + n + 1.
[null,null,["Последнее обновление: 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."]]