Vòng đời của nhãn

Nhãn, trường và lựa chọn trải qua các trạng thái cụ thể trong suốt cuộc sống. Ngoài ra, nhãn có thể có các bản sửa đổi khác nhau. Sơ đồ dưới đây cho thấy vòng đời của nhãn, bao gồm cả hoạt động sửa đổi:

Sơ đồ vòng đời của nhãn.
Hình 3. Vòng đời của một nhãn
  1. Tạo nhãn (create()) – Nhãn được tạo và lưu trữ trong cơ sở dữ liệu là revision_id=1. Nhãn có trạng thái UNPUBLISHED_DRAFT. Ở trạng thái này:
    • Người dùng không thể xem nhãn này
    • Người dùng không thể áp dụng nhãn cho các mục trên Drive.
  2. (không bắt buộc) Cập nhật nhãn, trường hoặc lựa chọn (delta()) – Mỗi bản cập nhật, ngay cả trước khi phát hành, đều được lưu trữ trong cơ sở dữ liệu và số lần sửa đổi của nhãn sẽ tăng lên.
  3. 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ẽ tăng số lần sửa đổi.
  4. (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 có trạng thái PUBLISHED với hasUnpublishedChanges=true nghĩa là có các thay đổi nháp nhưng không dành cho người dùng. Mỗi lần cập nhật sẽ tăng số sửa đổi của nhãn.
  5. (không bắt buộc) Phát hành nhãn (publish()) – Nếu có, bản nháp mới nhất sẽ được phát hành. 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 số phiên bản của nhãn.
  6. 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 đã tắt sẽ không xuất hiện trong giao diện người dùng trừ phi được định cấu hình để hiện. Việc ngừng sử dụng nhãn sẽ làm tăng bản sửa đổi.
  7. Bật nhãn (enable()) – Nhãn được đưa 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ẽ tăng số lần sửa đổi.
  8. 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á hoàn toàn.

Điều quan trọng cần nhấn mạnh là mỗi cập nhật cho một nhãn sẽ làm tăng giá trị sửa đổi của nhãn. Nếu nhãn đã được phát hành, thì việc phát hành lại nhãn sau khi n cập nhật có nghĩa là số bản sửa đổi đã phát hành của nhãn là bản sửa đổi + n + 1 số lần cập nhật liên tiếp.