Ringkasan label
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Label adalah metadata yang Anda tentukan untuk membantu pengguna mengatur, menemukan, dan menerapkan kebijakan pada file di Google Drive. Drive API memungkinkan developer
menerapkan label ke file dan folder, menetapkan nilai kolom label, membaca label dan nilai kolom pada file, serta menelusuri file menggunakan istilah metadata yang ditentukan oleh taksonomi label kustom.
Label Drive dapat mendukung proses bisnis dengan melampirkan metadata ke file dan folder. Penggunaan umum label adalah:
Mengklasifikasikan konten agar mengikuti strategi tata kelola informasi—Buat label untuk mengidentifikasi konten sensitif atau data yang memerlukan penanganan khusus.
Misalnya, Anda dapat membuat label dengan badge (label dengan nilai opsi berkode warna) berjudul "Sensitivitas" dengan nilai "Sangat Rahasia", "Rahasia", dan "Publik".
Menerapkan kebijakan ke item di Drive—Buat label untuk mengelola konten Drive di sepanjang siklus prosesnya dan pastikan konten tersebut mematuhi praktik penyimpanan data organisasi Anda. Misalnya, gunakan label untuk mengelola kebijakan pencegahan kebocoran data (DLP) yang melarang pengguna mendownload file dengan label "Sensitivitas" yang ditetapkan ke "Sangat Rahasia".
Menyeleksi dan menemukan file—Buat label untuk meningkatkan kemudahan penelusuran konten perusahaan Anda dengan memungkinkan orang di organisasi Anda menemukan item berdasarkan label dan kolomnya. Misalnya, terapkan set label "Status Tanda Tangan" ke "Menunggu Tanda Tangan" untuk semua kontrak yang menunggu tanda tangan hingga tanggal tertentu. Penelusuran Drive kemudian dapat menampilkan kontrak ini saat seseorang menelusuri "menunggu tanda tangan".
Berikut adalah daftar istilah umum yang digunakan oleh label Drive:
- Label
Metadata terstruktur yang ditempatkan pada file Drive.
Pengguna Drive dapat menetapkan label dan menetapkan nilai kolom label untuk file. Label terdiri dari:
- Nama label
- Nama resource label. ID label adalah bagian dari
Nama label. Bergantung pada permintaan, nama tersebut dalam bentuk:
labels/{id} atau labels/{id}@{revisionId}. Untuk mengetahui informasi selengkapnya, lihat
Revisi label di bawah.
- ID Label
- ID unik global untuk label. ID adalah bagian dari
nama label, tetapi tidak seperti nama, ID konsisten di antara revisi.
- Kolom
Komponen label yang dapat diketik dan ditetapkan secara individual. Label dapat memiliki nol atau lebih kolom yang terkait dengannya. Kolom pilihan dan pengguna dapat ditetapkan dengan
beberapa nilai jika kolom dikonfigurasi dengan
ListOptions di
Google Drive Labels API.
- Jenis kolom
- Jenis data nilai yang terkait dengan kolom. Dapat dikonfigurasi sebagai
integer, dateString, text, user, atau selection. Jenis yang dipilih memengaruhi
nilai valid yang berlaku untuk item Drive dan opsi kueri penelusuran yang tersedia.
- Taksonomi label
Kolom label yang dikonfigurasi tersedia bagi pengguna untuk diterapkan ke file Drive. Dapat dibaca dan ditulis melalui
Drive Labels API. Juga dikenal sebagai skema label.
- Revisi label
Instance label. Setiap kali label dibuat, diperbarui, dipublikasikan, atau dihentikan penggunaannya, revisi label akan bertambah.
- Revisi draf
- Nomor revisi instance draf label saat ini. Anda dapat
melakukan beberapa pembaruan pada label, yang masing-masing akan menaikkan nomor revisi drafnya, tanpa memengaruhi revisi yang dipublikasikan. Kemampuan untuk memiliki
label draf memungkinkan Anda menguji pembaruan label sebelum dipublikasikan.
- Revisi yang dipublikasikan
- Nomor revisi versi label yang dipublikasikan. Label yang dipublikasikan adalah instance label yang tersedia untuk pengguna.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-04 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-04 UTC."],[],[],null,["# Labels overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive API allows developers to\napply labels to files and folders, set label field values, read labels and field\nvalues on files, and search for files using metadata terms defined by the custom\nlabel taxonomy.\n\nDrive labels can support business processes by attaching metadata\nto files and folders. Common uses for labels are:\n\n- **Classify content to follow an information governance strategy**---Create a\n label to identify sensitive content or data that requires special handling.\n For example, you might create a badged label (a label with color-coded\n option values) titled \"Sensitivity\" with the values of \"Top Secret,\"\n \"Confidential,\" and \"Public.\"\n\n- **Apply policy to items in Drive**---Create labels to manage\n Drive content throughout its lifecycle and ensure it adheres\n to your organization's record keeping practices. For example, use labels to\n manage a data loss policy (DLP) whereby users can't download files with a\n \"Sensitivity\" label set to \"Top Secret\".\n\n- **Curate and find files**---Create labels to increase searchability of your\n company's content by letting people in your organization find items based on\n labels and their fields. For example, apply a \"Signature Status\" label set\n to \"Awaiting Signature\" to all contracts awaiting signature by a specific\n date. Drive search can then return these contracts when\n someone searches \"awaiting signature\".\n\nBelow is a list of common terms used by Drive labels:\n\n*Label*\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values\n for files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* is part of the\n Label name. Depending on the request, the name is in the form of either:\n `labels/{id}` or `labels/{id}@{revisionId}`. For more information, see\n [Label revision](#revision) below.\n\n *Label ID*\n : A globally unique identifier for the label. The ID is part of the\n label name, but unlike the name, it's consistent between revisions.\n\n*Field*\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it. Selection and user fields can be set with\n multiple values if the field is configured with\n [`ListOptions`](/workspace/drive/labels/reference/rest/v2/labels#listoptions) in the\n [Google Drive Labels API](/workspace/drive/labels/guides/overview).\n\n *Field type*\n : The data type of the value associated with the *field*. Configurable as\n integer, dateString, text, user, or selection. The type chosen impacts\n both the valid values applicable to Drive items and the\n search query options available.\n\n*Label taxonomy*\n\n: The configured label fields available to users for application to\n Drive files. Readable and writable through the\n Drive Labels API. Also known as the label schema.\n\n*Label revision*\n\n: An instance of the label. Anytime a label is created, updated, published, or\n deprecated, the label revision increments.\n\n *Draft revision*\n : The revision number of the current draft instance of the label. You can\n make several updates to a label, each incrementing its draft revision\n number, without affecting the published revision. The ability to have\n draft labels lets you test label updates before publishing.\n\n *Published revision*\n : The revision number of the published version of a label. The published\n label is the instance of the label available to users.\n\nRelated topics\n--------------\n\n- To learn about using labels in Drive, see [Set a label field\n on a file](/workspace/drive/api/guides/set-label).\n- Learn more about the [Drive Labels API](/workspace/drive/labels/guides/overview)."]]
