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 Labels API adalah RESTful API yang mendukung proses bisnis dengan melampirkan metadata ke file Drive Anda. Penggunaan umum untuk API ini 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 memastikan konten tersebut mematuhi praktik penyimpanan data organisasi Anda. Misalnya, gunakan label untuk
mengelola kebijakan pencegahan kebocoran data (DLP) yang menetapkan bahwa file dengan label "Sensitivitas" yang ditetapkan
ke "Sangat Rahasia" tidak dapat didownload ke komputer.
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, seseorang di organisasi Anda dapat menggunakan opsi penelusuran Drive untuk menemukan semua kontrak yang menunggu tanda tangan hingga tanggal tertentu.
Berikut adalah daftar istilah umum yang digunakan dalam Drive Labels API:
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 membentuk 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 membentuk bagian dari nama label, tetapi tidak seperti nama, ID konsisten di antara revisi.
Ada 2 gaya label:
Label dengan badge
Label dengan jenis kolom
SelectionOptions
yang berisi pilihan yang dapat diberi kode warna untuk menunjukkan
kepentingan. Hal ini dilakukan dengan menyetel
badgeConfig
melalui
Properties dari
Choice.
Drive menampilkan warna opsi yang dipilih untuk setiap file sehingga pengguna dapat memahami dengan jelas status, klasifikasi, dan sebagainya dari file tersebut.
Misalnya, opsi "Sangat Rahasia" untuk label dengan badge "Sensitivitas"
mungkin ditampilkan dalam warna merah. Anda hanya dapat memiliki satu label yang diberi badge dalam satu waktu.
Label standar
Label yang berisi nol atau lebih jenis kolom. Label standar mungkin memiliki judul label, seperti "Project Moonshot", dan menunjukkan semua file yang terkait dengan project tersebut. Label standar juga dapat memiliki beberapa kolom terstruktur. Misalnya, label dengan judul "Kontrak" dapat berisi kolom untuk "Perusahaan", "Batas Waktu", "Status", dan "Penandatangan". Setiap kolom memiliki jenis tertentu (teks, tanggal,
pilihan, atau pengguna).
Komponen label yang dapat diketik dan ditetapkan secara individual. Label dapat memiliki nol atau lebih kolom yang terkait dengannya.
Jenis kolom
Jenis data nilai yang terkait dengan kolom. Dapat dikonfigurasi sebagai
teks, bilangan bulat, tanggal, pengguna, atau pilihan. Jika mengonfigurasi kolom dengan
ListOptions, Anda dapat menetapkan kolom pengguna dan pilihan dengan beberapa
nilai. Jenis yang dipilih memengaruhi nilai valid yang berlaku untuk item Drive dan opsi kueri penelusuran yang tersedia.
Semua label menyertakan LabelType. Ada 2 jenis label:
Admin
Untuk membuat dan mengedit label milik admin, Anda harus menjadi administrator akun dengan hak istimewa Mengelola Label.
Admin dapat membagikan label admin kepada pengguna mana pun untuk memberi pengguna tersebut kemampuan melihat dan menerapkan label ke item Drive. Mengubah atau membaca nilai label pada item Drive memerlukan izin berikut:
Mengubah—Agar pengguna dapat mengubah metadata item Drive yang terkait dengan
label tertentu, pengguna harus memiliki tingkat izin yang sesuai:
Item Drive: EDITOR
Label: APPLIER
Membaca—Agar pengguna dapat membaca atau menelusuri metadata item Drive yang terkait dengan label tertentu, pengguna harus memiliki tingkat izin yang sesuai:
Item Drive: READER
Label: READER
Shared
Pengguna non-administrator dapat membuat label bersama yang dapat diterapkan orang lain ke item Drive. Tim dapat membuat dan mengatur labelnya sendiri untuk digunakan dalam tim tanpa memerlukan administrator.
Taksonomi label
Kolom label yang saat ini dikonfigurasi dan tersedia bagi pengguna untuk diterapkan ke file Drive. Juga dikenal sebagai skema label.
Contoh taksonomi label:
Sensitivitas—Merah, Oranye, Kuning, Hijau
Status—Belum Dimulai, Draf, Sedang Ditinjau, Final
Jenis konten—Kontrak, Dokumen Desain, Mockup
Departemen—Pemasaran, Keuangan, Sumber Daya Manusia, Penjualan
Label menjalani siklus proses saat dibuat, dipublikasikan, diperbarui, dan sebagainya. Saat label melewati siklus proses, revisi label-nya akan
ditambah. Untuk mengetahui informasi selengkapnya, lihat Siklus proses 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 saat ini tersedia untuk pengguna.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[],[],null,["# Drive Labels API overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive Labels API is a RESTful API that\nsupports business processes by attaching metadata to your Drive\nfiles. Common uses for this API 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 files with a \"Sensitivity\" label set\n to \"Top Secret\" can't be downloaded to a computer.\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, someone in your organization could use\n Drive search options to find all contracts awaiting signature\n by a specific date.\n\nBelow is a list of common terms used in the Drive Labels API:\n\n[*Label*](/workspace/drive/labels/reference/rest/v2/labels#resource:-label)\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values for\n files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* makes up 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 makes up part of the\n label name, but unlike the name, it's consistent between revisions.\n\n There are 2 styles of labels:\n\n *Badged label*\n\n : A label with a\n [`SelectionOptions`](/workspace/drive/labels/reference/rest/v2/labels#selectionoptions)\n field type containing *choices* that can be color-coded to indicate\n importance. This is done by setting\n [`badgeConfig`](/workspace/drive/labels/reference/rest/v2/labels#BadgeConfig)\n through the\n [`Properties`](/workspace/drive/labels/reference/rest/v2/labels#properties_1) of a\n [`Choice`](/workspace/drive/labels/reference/rest/v2/labels#choice).\n\n Drive displays the color of the chosen option for each file so users\n clearly understand the status, classification, and so on, of the file.\n For example, the \"Top Secret\" option for the \"Sensitivity\" badged label\n might display in red. You can only have one badged label at a time.\n\n *Standard label*\n\n : A label containing zero or more *field type*s. A standard label might\n have a label title, such as \"Project Moonshot,\" and indicate all files\n related to the project. A standard label might also have several\n structured fields. For example, a label with the title \"Contract\" might\n contain the fields for \"Company,\" \"Due Date,\" \"Status,\" and\n \"Signatories.\" Each field is of a specific type (text, date,\n selection, or user).\n\n|----------------------------|------------------------------|\n| **Figure 1.** Badged label | **Figure 2.** Standard label |\n\n[*Field*](/workspace/drive/labels/reference/rest/v2/labels#field)\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it.\n\n *Field type*\n : The data type of the value associated with the *field* . Configurable as\n text, integer, date, user, or selection. If you configure the field with\n `ListOptions`, you can set the user and selection fields with multiple\n values. The type chosen impacts both the valid values applicable to\n Drive items and the search query options available.\n\n[*Choice*](/workspace/drive/labels/reference/rest/v2/labels#choice)\n\n: One of several options a user can choose from within a `SelectionOptions`\n field.\n\n[*Label type*](/workspace/drive/labels/reference/rest/v2/labels#labeltype)\n\n: All labels include a `LabelType`. There are 2 types of labels:\n\n *Admin*\n\n : To create and edit admin-owned labels, you must be an account\n administrator with the\n [Manage Labels](https://support.google.com/a/answer/1219251#drive_and_docs)\n privilege.\n\n Admins can share admin labels with any user to grant that user the\n ability to view and apply them to Drive items. Modifying or reading\n label values on Drive items requires the following permissions:\n\n - Modifying---For a user to modify the Drive item metadata related to a\n given label, the user must have the appropriate permission levels:\n\n - Drive item: `EDITOR`\n - Label: `APPLIER`\n - Reading---For a user to read or search for the Drive item metadata\n related to a given label, the user must have the appropriate\n permission levels:\n\n - Drive item: `READER`\n - Label: `READER`\n\n *Shared*\n\n : Non-administrator users can create shared labels that others can apply\n to Drive items. Teams can create and organize their own labels for use\n within the team without requiring an administrator.\n\n | **Note:** Shared labels are only available in a closed beta that isn't currently accepting new customers.\n\n*Label taxonomy*\n\n: The currently configured label fields available to users for application to\n Drive files. Also known as the label schema.\n\n Example label taxonomies:\n\n - Sensitivity---Red, Orange, Yellow, Green\n - Status---Not Started, Draft, In Review, Final\n - Content type---Contract, Design Doc, Mockup\n - Department---Marketing, Finance, Human Resources, Sales\n\n[*Label lifecycle*](/workspace/drive/labels/reference/rest/v2/labels#lifecycle)\n\n: Labels go through a lifecycle where they're created, published, updated, and\n so on. As a label makes it through the lifecycle, its *label revision* is\n incremented. For more information, see [Label lifecycle](/workspace/drive/labels/guides/label-lifecycle).\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 currently available to users.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Get started as a\n Google Workspace\n developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Labels API app, try the\n [Python quickstart](/workspace/drive/labels/quickstart/python)."]]
