Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nhãn, trường và lựa chọn sẽ trải qua các trạng thái cụ thể trong suốt thời gian tồn tại.
Ngoài ra, nhãn có thể có nhiều phiên bản. Sơ đồ sau đây cho thấy vòng đời của nhãn, bao gồm cả việc sửa đổi:
Hình 3. Vòng đời của nhãn
Tạo nhãn (create()) – Nhãn được tạo và lưu trữ trong cơ sở dữ liệu dưới dạng revision_id=1. Nhãn có trạng thái là UNPUBLISHED_DRAFT.
Trong trạng thái này:
Người dùng không thể xem nhãn
Người dùng không thể áp dụng nhãn này cho các mục trên Drive.
(không bắt buộc) Cập nhật nhãn, trường hoặc lựa chọn (delta()) – Mọi nội dung cập nhật, ngay cả trước khi được xuất bản, đều được lưu trữ trong cơ sở dữ liệu và phiên bản của nhãn sẽ tăng lên.
Xuất bản nhãn (publish()) – Nhãn có trạng thái PUBLISHED và người dùng có thể áp dụng nhãn. Việc xuất bản nhãn sẽ làm tăng số phiên bản của nhãn.
(không bắt buộc) Cập nhật nhãn, trường hoặc lựa chọn (delta()) – Nhãn, trường hoặc lựa chọn được cập nhật và lưu trữ trong cơ sở dữ liệu dưới dạng nhãn nháp. Nhãn này có trạng thái PUBLISHED với hasUnpublishedChanges=true, tức là có các thay đổi nháp nhưng người dùng không thể sử dụng. Mỗi lần cập nhật sẽ tăng số phiên bản của nhãn.
(không bắt buộc) Xuất bản nhãn (publish()) – Nếu có, bản nháp mới nhất sẽ được xuất bản. Nhãn có trạng thái PUBLISHED và người dùng có thể áp dụng nhãn. Việc xuất bản nhãn sẽ tăng phiên bản của nhãn.
Tắt nhãn (disable()) – Nhãn có trạng thái DISABLED mặc dù người dùng có thể áp dụng nhãn thông qua API. Tuy nhiên, nhãn bị vô hiệu hoá sẽ không xuất hiện trong giao diện người dùng, trừ phi được định cấu hình để xuất hiện. Việc ngừng sử dụng nhãn sẽ làm tăng số lần sửa đổi.
Bật nhãn (enable()) – Nhãn sẽ trở về trạng thái PUBLISHED và người dùng có thể áp dụng nhãn. Việc xuất bản nhãn sẽ làm tăng số phiên bản của nhãn.
Xoá nhãn (delete()) – Nhãn có trạng thái DELETED và không thể áp dụng. Các nhãn đã xoá cuối cùng sẽ bị xoá vĩnh viễn.
Điều quan trọng cần nhấn mạnh là mọi nội dung cập nhật cho một nhãn đều làm tăng số phiên bản của nhãn đó. Ngoài ra, nếu nhãn đã được xuất bản, việc xuất bản lại nhãn đó sau n lần cập nhật có nghĩa là số phiên bản đã xuất bản của nhãn đó là phiên bản + n + 1 số lần cập nhật liên tiếp.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
