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 cuộc đời chú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ả 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 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 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à mức sửa đổi nhãn sẽ tăng lên.
  3. 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.
  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 này có trạng thái PUBLISHED với hasUnpublishedChanges=true có nghĩa là có các thay đổi ở bản nháp, nhưng người dùng không thể sử dụng các thay đổi đó. Mỗi lần cập nhật đều tăng bản 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 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 xuất bản 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 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ẽ tăng số lần sửa đổi.
  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 xuất bản nhãn sẽ làm tăng số lần sửa đổi nhãn.
  8. Xoá nhãn (delete()) – Nhãn có trạng thái DELETED và không thể áp dụng. Cuối cùng, các nhãn đã xoá sẽ được xoá hoàn toàn.

Quan trọng là bạn phải nhấn mạnh rằng mỗi lần cập nhật đối với một nhãn sẽ làm tăng số lần sửa đổi của nhãn đó. Và nếu nhãn đã được xuất bản, thì việc xuất bản lại sau n lầ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ố bản cập nhật liên tiếp.