Menghapus label dari file

Halaman ini menjelaskan cara menghapus label di satu file Google Drive.

Untuk menghapus metadata label file dari file, gunakan metode files.modifyLabels. Isi permintaan berisi instance ModifyLabelsRequest untuk mengubah kumpulan label pada file. Permintaan tersebut mungkin berisi beberapa modifikasi yang diterapkan secara atomik. Artinya, jika ada modifikasi yang tidak valid, seluruh update tidak akan berhasil dan tidak ada perubahan (kemungkinan yang bergantung) yang diterapkan.

ModifyLabelsRequest berisi instance LabelModification yang merupakan modifikasi pada label di file. Objek ini juga dapat berisi instance FieldModification yang merupakan modifikasi pada kolom label. Untuk menghapus label dari file, tetapkan FieldModification.removeLabel ke True.

Jika berhasil, isi respons akan berisi label yang ditambahkan atau diperbarui oleh permintaan. Keduanya ada dalam objek modifiedLabels jenis Label.

Contoh

Contoh kode berikut menunjukkan cara menggunakan labelId untuk menghapus semua kolom yang terkait dengan label menggunakan fileId. Misalnya, jika sebuah label berisi kolom teks dan pengguna, menghapus label akan menghapus baik kolom teks maupun kolom pengguna yang terkait dengan label. Sementara itu, menghapus setelan kolom teks akan menghapusnya dari label, tetapi membiarkan kolom pengguna tidak disentuh. Untuk mengetahui informasi selengkapnya, lihat Membatalkan setelan kolom label di file.

Java

ModifyLabelsRequest modifyLabelsRequest =
  new ModifyLabelsRequest()
      .setLabelModifications(
          ImmutableList.of(
              new LabelModification()
                .setLabelId("LABEL_ID")
                .setRemoveLabel(true)));

ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).execute();

Python

label_modification = {'labelId':'LABEL_ID', 'removeLabel': True]}

modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications' : [label_modification]}).execute();

Node.js

/**
* Remove a label on a Drive file
* @return{obj} updated label data
**/
async function removeLabel() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  const labelModification = {
    'labelId': 'LABEL_ID',
    'removeLabel': True,
  };
  const labelModificationRequest = {
    'labelModifications': [labelModification],
  };
  try {
    const updateResponse = await service.files.modifyLabels({
      fileId: 'FILE_ID',
      resource: labelModificationRequest,
    });
    return updateResponse;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }

Ganti kode berikut:

  • LABEL_ID: labelId label yang akan diubah. Untuk menemukan label pada file, gunakan metode files.listLabels.
  • FILE_ID: fileId file yang labelnya akan diubah.