Siklus proses label

Label, kolom, dan pilihan akan melalui status tertentu selama masa aktifnya. 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. Membuat 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 pembaruan, bahkan sebelum dipublikasikan, disimpan dalam database, dan revisi label akan bertambah.
  3. Memublikasikan label (publish())—Label memiliki status PUBLISHED dan pengguna dapat menerapkan label. Memublikasikan 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 pembaruan akan menambah revisi label.
  5. (opsional) Publikasikan label (publish())—Jika tersedia, draf terbaru akan dipublikasikan. Label memiliki status PUBLISHED dan pengguna dapat menerapkan label. Memublikasikan label akan menambah versinya.
  6. Menonaktifkan 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. Mengaktifkan label (enable())—Label dikembalikan ke status PUBLISHED dan pengguna dapat menerapkan label. Memublikasikan label akan menambah revisinya.
  8. Menghapus label (delete())—Label memiliki status DELETED dan tidak dapat diterapkan. Label yang dihapus pada akhirnya akan dihapus.

Penting untuk menekankan bahwa setiap pembaruan pada label akan menambah revisi label. Selain itu, jika label telah dipublikasikan, memublikasikannya lagi setelah n update berarti nomor revisi yang dipublikasikan adalah revisi + n + 1 jumlah update berturut-turut.