Menonaktifkan, mengaktifkan, dan menghapus label

Dokumen ini menjelaskan cara melakukan tugas-tugas yang melibatkan label berikut:

  • Menonaktifkan label
  • Mengaktifkan label
  • Menghapus label

Menonaktifkan label

Menonaktifkan label akan menghasilkan revisi yang dipublikasikan dan dinonaktifkan berdasarkan revisi yang dipublikasikan saat ini. Jika ada revisi draf, revisi draf baru yang dinonaktifkan dibuat berdasarkan revisi draf terbaru. Revisi draf yang lebih lama dihapus. Untuk mengetahui informasi selengkapnya, lihat Siklus proses label.

Setelah dinonaktifkan, pengguna masih dapat menerapkan label ini melalui Google Drive Labels API. Label tetap muncul di tempatnya telah diterapkan dan di hasil penelusuran Anda. Label yang dinonaktifkan dapat dihapus.

Untuk menonaktifkan label yang dipublikasikan, gunakan metode disable pada resource labels.

Anda juga harus menentukan:

  • Resource labels yang merepresentasikan label. Kolom ini berisi name dan id, yang merupakan ID unik global untuk label.

  • Parameter kueri useAdminAccess ditetapkan ke true untuk menggunakan kredensial administrator pengguna. Sebelum mengizinkan akses, server memverifikasi bahwa pengguna memiliki hak istimewa administrator Kelola Label Klasifikasi yang diperlukan.

Contoh kode berikut menunjukkan cara menggunakan id label untuk menonaktifkan label yang benar:

Python

service.labels().disable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.disable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Ganti ID dengan ID label yang akan dinonaktifkan.

Label memiliki State dari DISABLED dan ID revisi label bertambah. Pengguna dapat menerapkan label melalui Drive Labels API. Namun, label yang dinonaktifkan tidak ditampilkan di UI kecuali jika kolom showInApply objek DisabledPolicy dikonfigurasi.

Mengaktifkan label

Mengaktifkan label yang dinonaktifkan akan memulihkannya ke status dipublikasikan. Hal ini akan menghasilkan revisi baru yang dipublikasikan berdasarkan revisi yang dipublikasikan saat ini yang dinonaktifkan. Jika ada revisi draf yang sudah ada dan dinonaktifkan, revisi baru akan dibuat berdasarkan draf tersebut dan diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Siklus proses label.

Untuk mengaktifkan label yang dinonaktifkan, gunakan metode enable pada resource labels.

Anda juga harus menentukan:

  • Resource labels yang merepresentasikan label. Kolom ini berisi name dan id, yang merupakan ID unik global untuk label.

  • Parameter kueri useAdminAccess ditetapkan ke true untuk menggunakan kredensial administrator pengguna. Sebelum mengizinkan akses, server memverifikasi bahwa pengguna memiliki hak istimewa administrator Kelola Label Klasifikasi yang diperlukan.

Contoh kode berikut menunjukkan cara menggunakan id label untuk mengaktifkan label yang benar:

Python

service.labels().enable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.enable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Ganti ID dengan ID label yang akan diaktifkan.

Label memiliki State dari PUBLISHED dan ID revisi label bertambah. Pengguna dapat melihat dan menerapkan label ke file melalui Drive Labels API.

Menghapus label

Hanya label draf dan nonaktif yang dapat dihapus. Jika label dihapus, semua instance tempat label tersebut diterapkan sebelumnya, termasuk nilai kolom yang sesuai yang dimasukkan oleh pengguna, akan dihapus secara permanen dan dihapus dari file Drive tersebut.

Untuk menghapus label, Anda harus menonaktifkannya terlebih dahulu, lalu menggunakan metode delete pada resource labels.

Anda juga harus menentukan:

  • Resource labels yang merepresentasikan label. Kolom ini berisi name dan id, yang merupakan ID unik global untuk label.

  • Parameter kueri useAdminAccess ditetapkan ke true untuk menggunakan kredensial administrator pengguna. Sebelum mengizinkan akses, server memverifikasi bahwa pengguna memiliki hak istimewa administrator Kelola Label Klasifikasi yang diperlukan.

Contoh kode berikut menunjukkan cara menggunakan id label untuk menghapus label yang benar:

Python

response = service.labels().delete(
    name='labels/ID',
    useAdminAccess=True
).execute()

Node.js

service.labels.delete({
  name: 'labels/ID',
  useAdminAccess: true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Ganti ID dengan ID label yang akan dihapus.

Label memiliki State dari DELETED dan ID revisi label bertambah. Label tidak dapat diterapkan dan label yang dihapus akan dihapus secara permanen. Untuk mengetahui informasi selengkapnya, lihat Siklus proses label.