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. Biểu đồ dưới đây cho thấy vòng đời của nhãn, bao gồm cả 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 một 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 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.
  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. Chiến lược phát hành đĩa đơn nhãn có trạng thái PUBLISHED 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.
  5. (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á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 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 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.
  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 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.