Vòng đời của nhã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 hoạt động. Ngoài ra, nhãn có thể có nhiều bản sửa đổi. Sơ đồ sau đây cho thấy vòng đời của nhãn, bao gồm cả việc sửa đổi:

Sơ đồ vòng đời của nhãn.
Hình 3. Vòng đời của nhãn
  1. 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. Ở 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.
  2. (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 phát hành, đều được lưu trữ trong cơ sở dữ liệu và bản sửa đổi của nhãn sẽ được tăng lên.
  3. Xuất bản 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 phát hành nhãn sẽ làm tăng số lần sửa đổi của nhãn đó.
  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 có nghĩa 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ố lần sửa đổi của nhãn.
  5. (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 là PUBLISHED và người dùng có thể áp dụng nhãn. Việc phát hành nhãn sẽ làm tăng phiên bản của nhãn đó.
  6. Tắt nhãn (disable()) – Nhãn có trạng thái là 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ị tắt sẽ không xuất hiện trong giao diện người dùng trừ khi được định cấu hình để hiển thị. Việc ngừng sử dụng nhãn sẽ làm tăng số lần sửa đổi của nhãn đó.
  7. Bật nhãn (enable()) – Nhãn được trả về trạng thái PUBLISHED và người dùng có thể áp dụng nhãn. Việc phát hành nhãn sẽ làm tăng số lần sửa đổi của nhãn đó.
  8. 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ẽ bị xoá bỏ.

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