Ringkasan Drive Labels API

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 atau data sensitif yang memerlukan penanganan khusus. Misalnya, Anda dapat membuat label dengan badge (label dengan nilai opsi berkode warna) berjudul "Sensitivitas" dengan nilai "Sulit Diungkapkan", "Rahasia", dan "Publik".

  • Menerapkan kebijakan ke item di Drive—Buat label untuk mengelola konten Drive di sepanjang siklus prosesnya dan memastikannya mematuhi praktik penyimpanan data organisasi Anda. Misalnya, gunakan label untuk mengelola kebijakan pencegahan kebocoran data (DLP) sehingga 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 di Drive Labels API:

Label

Metadata terstruktur yang ditempatkan di file Drive. Pengguna Drive dapat menetapkan label dan menetapkan nilai kolom label untuk file. Label terdiri dari:

Nama label
Nama resource label. ID label merupakan bagian dari Nama label. Bergantung pada permintaan, namanya dalam bentuk: labels/{id} atau labels/{id}@{revisionId}. Untuk informasi selengkapnya, lihat Revisi label di bawah.
ID Label
ID unik global untuk label. ID ini merupakan bagian dari nama label, tetapi tidak seperti nama, ID ini 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 pentingnya. Hal ini dilakukan dengan menetapkan badgeConfig melalui Properties dari Choice.

Drive menampilkan warna opsi yang dipilih untuk setiap file sehingga pengguna dapat memahami status, klasifikasi, dan sebagainya dari file dengan jelas. Misalnya, opsi "Sangat Rahasia" untuk label dengan badge "Sensitivitas" mungkin ditampilkan dalam warna merah. Anda hanya dapat memiliki satu label dengan badge dalam 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 project. Label standar mungkin juga memiliki beberapa kolom terstruktur. Misalnya, label dengan judul "Kontrak" mungkin berisi kolom untuk "Perusahaan", "Batas Waktu", "Status", dan "Penanda Tangan". Setiap kolom memiliki jenis tertentu (teks, tanggal, pilihan, atau pengguna).

Diagram label dengan badge.
Gambar 1. Label dengan badge
Diagram label standar.
Gambar 2. Label standar
Kolom

Komponen label individual yang diketik dan dapat ditetapkan. Label dapat memiliki nol atau beberapa 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.
Choice

Salah satu dari beberapa opsi yang dapat dipilih pengguna dalam kolom SelectionOptions.

Jenis label

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 menerapkannya 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 oleh 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 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
Siklus proses label

Label akan melalui siklus proses pembuatan, publikasi, pembaruan, dan sebagainya. Saat label melewati siklus proses, revisi label-nya akan bertambah. Untuk mengetahui informasi selengkapnya, lihat Siklus proses label.

Revisi label

Instance label. Setiap kali label dibuat, diperbarui, dipublikasikan, atau tidak digunakan lagi, revisi label akan bertambah.

Revisi draf
Nomor revisi instance draf label saat ini. Anda dapat melakukan beberapa pembaruan pada label, yang masing-masing akan menambah nomor revisi drafnya, tanpa memengaruhi revisi yang dipublikasikan. Kemampuan untuk memiliki label draf memungkinkan Anda menguji pembaruan label sebelum memublikasikannya.
Revisi yang dipublikasikan
Nomor revisi versi label yang dipublikasikan. Label yang dipublikasikan adalah instance label yang saat ini tersedia untuk pengguna.