Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Label, kolom, dan pilihan melewati status tertentu selama masa pakainya.
Selain itu, label mungkin memiliki revisi yang berbeda. Diagram berikut menunjukkan
siklus proses label, termasuk revisi:
Gambar 3. Siklus proses label
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.
(opsional) Perbarui label, kolom, atau pilihan (delta())— Setiap pembaruan, bahkan sebelum dipublikasikan, disimpan dalam database, dan revisi label akan bertambah.
Memublikasikan label (publish())—Label memiliki status PUBLISHED dan
pengguna dapat menerapkan label. Memublikasikan label akan menambah revisinya.
(opsional) Perbarui label, kolom, atau pilihan (delta())— Label, kolom, atau pilihan diperbarui dan disimpan dalam database sebagai draf label. Label
memiliki status PUBLISHED dengan hasUnpublishedChanges=true yang berarti
ada perubahan draf, tetapi perubahan tersebut tidak tersedia bagi pengguna. Setiap pembaruan akan menaikkan revisi label.
(opsional) Publikasikan label (publish())—Jika tersedia, draf
terbaru akan dipublikasikan. Label memiliki status PUBLISHED dan pengguna dapat
menerapkan label. Memublikasikan label akan menaikkan versinya.
Menonaktifkan label (disable())—Label memiliki status DISABLED
meskipun pengguna dapat menerapkan label melalui API. Namun, label nonaktif
tidak ditampilkan di UI kecuali jika dikonfigurasi untuk ditampilkan. Menghentikan penggunaan label akan menaikkan revisinya.
Mengaktifkan label (enable())—Label dikembalikan ke status PUBLISHED
dan pengguna dapat menerapkan label. Memublikasikan label akan menambah revisinya.
Menghapus label (delete())—Label memiliki status DELETED dan tidak dapat diterapkan. Label yang dihapus pada akhirnya akan dihapus permanen.
Penting untuk menekankan bahwa setiap pembaruan pada label akan meningkatkan revisi label. Selain itu, jika label telah dipublikasikan, memublikasikannya lagi
setelah n pembaruan berarti nomor revisi yang dipublikasikan adalah revisi + n + 1
jumlah pembaruan berturut-turut.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[],[],null,["# Label lifecycle\n\nLabels, fields, and choices go through specific states throughout their lives.\nAdditionally, labels might have different revisions. The following diagram shows\nthe label lifecycle, including revisioning:\n**Figure 3.** Lifecycle of a label\n\n1. **Create a label (`create()`)** ---The label is created and stored in a database as `revision_id=1`. The label has the state of `UNPUBLISHED_DRAFT`. In this state:\n - Users can't view the label\n - Users can't apply the label to Drive items.\n2. **(optional) Update a label, field, or choice (`delta()`)**--- Every update, even before it's published, is stored in a database, and the label's revision is incremented.\n3. **Publish a label (`publish()`)** ---The label has the state of `PUBLISHED` and users can apply the label. Publishing the label increments its revision.\n4. **(optional) Update a label, field, or choice (`delta()`)** --- The label, field, or choice is updated and stored in a database as a draft label. The label has the state of `PUBLISHED` with `hasUnpublishedChanges=true` meaning there are draft changes, but they aren't available to users. Each update increments the label's revision.\n5. **(optional) Publish a label (`publish()`)** ---If available, the most-current draft is published. The label has the state of `PUBLISHED` and users can apply the label. Publishing the label increments its version.\n6. **Disable a label (`disable()`)** ---The label has the state of `DISABLED` though users can apply the label through the API. However, a disabled label isn't shown in a UI unless configured to be shown. Deprecating the label increments its revision.\n7. **Enable a label (`enable()`)** ---The label is returned to a `PUBLISHED` state and users can apply the label. Publishing the label increments its revision.\n8. **Delete a label (`delete()`)** ---The label has a state of `DELETED` and can't be applied. Deleted labels are eventually purged.\n\nIt's important to emphasize that every update to a label increments the label's\nrevision. And, if the label has already been published, publishing it again\nafter *n* updates means that its published revision number is revision + *n* + 1\nnumber of successive updates."]]