Menonaktifkan, mengaktifkan & menghapus label

Halaman ini menjelaskan cara melakukan tugas berikut yang melibatkan label:

• Menonaktifkan label
• Mengaktifkan label
• Menghapus label

Menonaktifkan label

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

Setelah dinonaktifkan, pengguna masih dapat menerapkan label ini melalui API. Label akan tetap muncul di tempatnya 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. Class ini berisi resource Name dan ID, yang merupakan ID unik global untuk label.

• useAdminAccess adalah true untuk menggunakan kredensial administrator pengguna. Server 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 properti showInApply dari metode disabledPolicy dikonfigurasi.

Mengaktifkan label

Mengaktifkan label yang dinonaktifkan akan memulihkannya ke status dipublikasikan. Opsi ini menghasilkan revisi baru yang dipublikasikan berdasarkan revisi yang dipublikasikan saat ini yang dinonaktifkan. Jika 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. Class ini berisi resource Name dan ID, yang merupakan ID unik global untuk label.

• useAdminAccess adalah true untuk menggunakan kredensial administrator pengguna. Server 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 label draf dan label yang dinonaktifkan yang dapat dihapus. Saat label dihapus, semua instance tempat label sebelumnya diterapkan, termasuk nilai kolom terkait 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. Class ini berisi resource Name dan ID, yang merupakan ID unik global untuk label.

• useAdminAccess adalah true untuk menggunakan kredensial administrator pengguna. Server 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 informasi selengkapnya, lihat Siklus proses label.