Menonaktifkan, mengaktifkan & menghapus label

Halaman ini menjelaskan cara melakukan tugas berikut yang melibatkan label:

• Menonaktifkan label
• Mengaktifkan label
• Menghapus label

Menonaktifkan label

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

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

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

Anda juga harus menentukan:

• Resource label yang mewakili setiap label. File ini berisi resource Name dan ID, yang merupakan ID unik global untuk label.

• useAdminAccess adalah true untuk menggunakan kredensial administrator pengguna. Server akan memverifikasi bahwa pengguna adalah admin untuk label sebelum mengizinkan akses.

Contoh ini menggunakan ID untuk menonaktifkan label yang benar.

Python

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

Node.js

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

Label memiliki State dari DISABLED dan ID revisi label bertambah. Pengguna dapat menerapkan label melalui API. Namun, label yang dinonaktifkan tidak ditampilkan di UI kecuali jika properti showInApply dari metode disabledPolicy dikonfigurasi.

Mengaktifkan label

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

Untuk mengaktifkan label yang dinonaktifkan, gunakan metode enable.

Anda juga harus menentukan:

• Resource label yang mewakili setiap label. File ini berisi resource Name dan ID, yang merupakan ID unik global untuk label.

• useAdminAccess adalah true untuk menggunakan kredensial administrator pengguna. Server akan memverifikasi bahwa pengguna adalah admin untuk label sebelum mengizinkan akses.

Contoh ini menggunakan ID untuk mengaktifkan label yang benar.

Python

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

Node.js

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

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

Menghapus label

Hanya draf dan label yang dinonaktifkan 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.

Anda juga harus menentukan:

• Resource label yang mewakili setiap label. File ini berisi resource Name dan ID, yang merupakan ID unik global untuk label.

• useAdminAccess adalah true untuk menggunakan kredensial administrator pengguna. Server akan memverifikasi bahwa pengguna adalah admin untuk label sebelum mengizinkan akses.

Contoh ini menggunakan ID untuk menghapus label yang benar.

Python

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

Node.js

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

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