Siklus proses label

Label, {i>field<i}, dan pilihan melalui keadaan tertentu sepanjang hidupnya. Selain itu, label mungkin memiliki revisi yang berbeda. Diagram berikut menunjukkan siklus proses label, termasuk revisi:

Diagram siklus proses label.
Gambar 3. Siklus proses label
  1. Buat label (create())—Label dibuat dan disimpan dalam database sebagai revision_id=1. Label memiliki status UNPUBLISHED_DRAFT. Dalam status ini:
    • Pengguna tidak dapat melihat label
    • Pengguna tidak dapat menerapkan label ke item Drive.
  2. (opsional) Memperbarui label, kolom, atau pilihan (delta())— Setiap update, bahkan sebelum dipublikasikan, disimpan dalam database, dan revisi label akan bertambah.
  3. Publikasikan label (publish())—Label memiliki status PUBLISHED dan pengguna dapat menerapkan label. Penerbitan label akan menambah revisinya.
  4. (opsional) Memperbarui label, kolom, atau pilihan (delta())— Label, kolom, atau pilihan diperbarui dan disimpan dalam database sebagai label draf. Label memiliki status PUBLISHED dengan hasUnpublishedChanges=true yang berarti ada perubahan draf, tetapi tidak tersedia untuk pengguna. Setiap update akan menambah revisi label.
  5. (opsional) Memublikasikan label (publish())—Jika tersedia, draf terbaru akan dipublikasikan. Label memiliki status PUBLISHED dan pengguna dapat menerapkan label ini. Memublikasikan label akan meningkatkan versinya.
  6. Nonaktifkan label (disable())—Label memiliki status DISABLED, meskipun pengguna dapat menerapkan label melalui API. Namun, label yang dinonaktifkan tidak ditampilkan di UI kecuali jika dikonfigurasi untuk ditampilkan. Menghentikan penggunaan label akan meningkatkan revisinya.
  7. Aktifkan label (enable())—Label ditampilkan ke status PUBLISHED dan pengguna dapat menerapkan label. Penerbitan label akan menambah revisinya.
  8. Menghapus label (delete())—Label memiliki status DELETED dan tidak dapat diterapkan. Label yang dihapus pada akhirnya akan dihapus permanen.

Penting untuk ditekankan bahwa setiap update pada label akan meningkatkan revisi label. Selain itu, jika label telah dipublikasikan, memublikasikannya lagi setelah n diperbarui berarti bahwa nomor revisi yang dipublikasikan adalah revisi + n + 1 angka update berturut-turut.