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 yang dipublikasikan dan dinonaktifkan berdasarkan revisi yang dipublikasikan saat ini. Jika ada revisi draf, revisi draf baru yang dinonaktifkan akan dibuat berdasarkan revisi draf terbaru. Revisi draf yang lebih lama dihapus. Untuk mengetahui 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 merepresentasikan setiap label. Objek ini berisi Name dan ID resource, 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 jika properti showInApply dari metode 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 dan saat ini 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 kembali label yang dinonaktifkan, gunakan metode enable.

Anda juga harus menentukan:

• Resource label yang merepresentasikan setiap label. Objek ini berisi Name dan ID resource, 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 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.

Anda juga harus menentukan:

• Resource label yang merepresentasikan setiap label. Objek ini berisi Name dan ID resource, 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 akan dihapus pada akhirnya. Untuk mengetahui informasi selengkapnya, lihat Siklus proses label.