Nhãn, trường và lựa chọn sẽ trải qua các trạng thái cụ thể trong suốt cuộc đời chúng. Ngoài ra, nhãn có thể có các bản sửa đổi khác nhau. Biểu đồ dưới đây cho thấy vòng đời của nhãn, bao gồm cả sửa đổi:
- Tạo nhãn (
create()
) – Nhãn được tạo và lưu trữ trong một dưới dạngrevision_id=1
. Nhãn có trạng tháiUNPUBLISHED_DRAFT
. Ở 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 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 lần cập nhật, ngay cả trước khi được xuất bản, được lưu trữ trong cơ sở dữ liệu và sửa đổi sẽ tăng lên. - Xuất bản một nhãn (
publish()
) – Nhãn có trạng thái là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ố lần sửa đổi 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. Chiến lược phát hành đĩa đơn nhãn có trạng tháiPUBLISHED
với ý nghĩa làhasUnpublishedChanges=true
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 làm tăng bản sửa đổi của nhãn. - (không bắt buộc) Xuất bản một nhãn (
publish()
)—Nếu có, nhãn mới nhất bản nháp được xuất bản. Nhãn có trạng tháiPUBLISHED
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 phiên bản của nhãn. - Tắt nhãn (
disable()
) – Nhãn có trạng tháiDISABLED
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á không xuất hiện trong giao diện người dùng trừ phi được định cấu hình để hiển thị. Không dùng nhãn này nữa sẽ tăng mức độ sửa đổi. - Bật nhãn (
enable()
) – Nhãn được trả về trạng tháiPUBLISHED
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ố lần sửa đổi nhãn. - Xoá nhãn (
delete()
) – Nhãn có trạng thái làDELETED
và Không thể áp dụng. Cuối cùng, các nhãn đã xoá sẽ được xoá hoàn toàn.
Điều quan trọng là phải nhấn mạnh rằng mỗi lần cập nhật đối với nhãn sẽ làm tăng giá trị của bản sửa đổi này. Đồng thời, nếu nhãn đã được xuất bản, hãy xuất bản lại sau khi n cập nhật có nghĩa là số bản sửa đổi được xuất bản là bản sửa đổi + n + 1 số lần cập nhật liên tiếp.