Label adalah metadata yang Anda tentukan untuk membantu pengguna mengatur, menemukan, dan menerapkan kebijakan pada file di Google Drive. {i>Drive Labels API<i} adalah RESTful API yang mendukung proses bisnis dengan melampirkan metadata ke Drive Anda . Penggunaan umum untuk API ini adalah:
Mengklasifikasi konten agar mengikuti strategi tata kelola informasi—Buat label untuk mengidentifikasi konten atau data sensitif yang memerlukan penanganan khusus. Misalnya, Anda dapat membuat label dengan badge (label dengan kode warna nilai opsi) berjudul "Sensitivitas" dengan nilai "Top Secret", "Rahasia", dan "Publik".
Terapkan kebijakan ke item di Drive—Buat label untuk dikelola Mendorong konten sepanjang siklus prosesnya dan memastikan kepatuhannya bagi praktik penyimpanan data organisasi Anda. Misalnya, gunakan label untuk mengelola kebijakan kehilangan data (DLP) yang menampilkan file dengan "Sensitivitas" kumpulan label menjadi "Sangat Rahasia" tidak dapat diunduh ke komputer.
Menyeleksi dan menemukan file—Buat label untuk meningkatkan kemudahan penelusuran konten perusahaan dengan memungkinkan orang di organisasi Anda menemukan item berdasarkan label dan {i>field<i}-nya. Misalnya, seseorang di organisasi Anda dapat menggunakan Opsi penelusuran Drive untuk menemukan semua kontrak menunggu tanda tangan pada tanggal tertentu.
Di bawah ini adalah daftar istilah umum yang digunakan di Drive Labels API:
- Label
Metadata terstruktur yang ditempatkan pada file Drive. Pengguna Drive dapat menetapkan label dan menetapkan nilai kolom label untuk . Label terdiri dari:
- Nama label
- Nama resource label. ID label merupakan bagian dari
Nama label. Bergantung pada permintaannya, nama akan tersedia dalam bentuk:
labels/{id}
ataulabels/{id}@{revisionId}
. Untuk informasi selengkapnya, lihat Labeli revisi di bawah. - ID Label
- ID unik global untuk label. ID merupakan bagian dari nama label, tapi tidak seperti nama, ini konsisten di antara revisi.
Ada 2 gaya label:
- Label dengan badge
Label dengan
SelectionOptions
jenis kolom yang berisi pilihan yang dapat diberi kode warna untuk menunjukkan tingkat kepentingan. Hal ini dilakukan dengan mengaturbadgeConfig
melaluiProperties
dariChoice
.Drive menampilkan warna opsi yang dipilih untuk setiap file sehingga pengguna memahami status, klasifikasi, dan sebagainya, dari file tersebut. Misalnya, "Sangat Rahasia" opsi "Sensitivity" untuk label dengan badge mungkin ditampilkan dengan warna merah. Anda hanya boleh memiliki satu label dengan badge pada satu waktu.
- Label standar
Label yang berisi nol atau beberapa jenis kolom. Label standar mungkin memiliki judul label, seperti "Project Moonshot", dan menunjukkan semua file yang terkait dengan proyek. Label standar mungkin juga memiliki beberapa {i>structured<i}. Misalnya, label dengan judul "Kontrak" mungkin berisi bidang untuk "Perusahaan," "Batas Waktu", "Status", dan "Penandatangan". Setiap {i>field<i} memiliki jenis tertentu (teks, tanggal, pilihan, atau pengguna).
|
|
- Kolom
Komponen label individual yang diketik dan dapat disetel. Label dapat memiliki nol atau lebih banyak {i>field<i} yang terkait.
- Jenis kolom
- Jenis data nilai yang terkait dengan kolom. Dapat dikonfigurasi sebagai
teks, bilangan bulat, tanggal, pengguna, atau pilihan. Jika Anda mengonfigurasi
{i>field<i} dengan
ListOptions
, Anda dapat menetapkan kolom pengguna dan pilihan dengan beberapa masing-masing. Jenis yang dipilih memengaruhi nilai valid yang berlaku untuk Item Drive dan opsi kueri penelusuran tersedia.
- Pilihan
Salah satu dari beberapa opsi yang dapat dipilih pengguna dalam
SelectionOptions
kolom tersebut.- Jenis label
Semua label menyertakan
LabelType
. Ada 2 jenis label:- Admin
Untuk membuat dan mengedit label milik admin, akun Anda harus merupakan akun administrator dengan Mengelola Label istimewa tersebut.
Admin dapat membagikan label admin kepada pengguna mana pun untuk memberikan izin kemampuan untuk melihat dan menerapkannya ke item Drive. Mengubah atau membaca nilai label pada item Drive memerlukan izin berikut:
Memodifikasi—Agar pengguna dapat mengubah metadata item Drive yang terkait dengan label tertentu, pengguna harus memiliki tingkat izin yang sesuai:
- Item Drive:
EDITOR
- Label:
APPLIER
- Item Drive:
Membaca—Agar pengguna dapat membaca atau menelusuri metadata item Drive yang terkait dengan label tertentu, pengguna harus memiliki tingkat izin akses:
- Item Drive:
READER
- Label:
READER
- Item Drive:
Pengguna non-administrator dapat membuat label bersama yang dapat diterapkan orang lain ke item Drive. Tim dapat membuat dan mengatur label mereka sendiri untuk digunakan dalam tim tanpa memerlukan administrator.
- Taksonomi label
Kolom label yang saat ini dikonfigurasi tersedia bagi pengguna untuk 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, {i>Mockup<i}
- Departemen—Pemasaran, Keuangan, Sumber Daya Manusia, Penjualan
- Siklus proses label
Label menjalani siklus proses di mana label dibuat, dipublikasikan, diperbarui, dan dan seterusnya. Saat label berhasil melewati siklus proses, revisi labelnya adalah bertambah. Untuk informasi selengkapnya, lihat Siklus proses label.
- Revisi label
Instance label. Kapan pun label dibuat, diperbarui, dipublikasikan, atau tidak digunakan lagi, revisi label akan bertambah.
- Draf revisi
- Nomor revisi instance draf label saat ini. Anda dapat membuat beberapa pembaruan pada label, masing-masing menambah draf revisinya angka, tanpa mempengaruhi revisi yang diterbitkan. Kemampuan untuk memiliki draf label memungkinkan Anda menguji pembaruan label sebelum dipublikasikan.
- Revisi yang dipublikasikan
- Nomor revisi dari versi label yang dipublikasikan. yang dipublikasikan label adalah instance label yang saat ini tersedia untuk pengguna.
Topik terkait
Untuk mempelajari cara mengembangkan aplikasi dengan Google Workspace API, termasuk menangani terkait autentikasi dan otorisasi, lihat Memulai sebagai Google Workspace developer.
Untuk mempelajari cara mengonfigurasi dan menjalankan aplikasi Labels API sederhana, coba Panduan memulai Python.