Xoá nhãn khỏi tệp

Trang này mô tả cách xoá nhãn trên một tệp Google Drive.

Để xoá siêu dữ liệu nhãn tệp khỏi một tệp, hãy sử dụng Phương thức files.modifyLabels. Chiến lược phát hành đĩa đơn nội dung yêu cầu chứa một bản sao của ModifyLabelsRequest để sửa đổi nhóm nhãn trên tệp. Yêu cầu có thể chứa một số sửa đổi được áp dụng nguyên tử. Tức là, nếu có bất kỳ nội dung sửa đổi nào không hợp lệ thì toàn bộ quá trình cập nhật sẽ không thành công và không có cách nào (có thể phụ thuộc) sẽ được áp dụng.

ModifyLabelsRequest chứa một thực thể của LabelModification là sửa đổi đối với nhãn trên tệp. Tệp này cũng có thể chứa một phiên bản trong số FieldModification là sự sửa đổi đối với trường của nhãn. Cách xoá nhãn khỏi tệp: đặt FieldModification.removeLabel thành True.

Nếu thành công, phản hồi nội dung chứa các nhãn được thêm hoặc cập nhật theo yêu cầu. Các tham số này tồn tại trong một Đối tượng modifiedLabels thuộc loại Label.

Ví dụ:

Mã mẫu sau đây cho biết cách dùng labelId để xoá tất cả trường được liên kết với nhãn đó bằng fileId. Ví dụ: nếu nhãn chứa cả trường văn bản và trường người dùng, việc xóa nhãn sẽ xóa cả văn bản và người dùng các trường được liên kết với nhãn. Trong khi đó, khi bạn huỷ thiết lập trường văn bản, trường đó sẽ bị xoá khỏi nhãn nhưng giữ nguyên trường người dùng. Để biết thêm thông tin, hãy xem Bỏ đặt trường nhãn trên tệp.

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;
  }

Thay thế đoạn mã sau:

  • LABEL_ID: labelId của nhãn cần sửa đổi. Để định vị các nhãn trên một tệp, hãy sử dụng Phương thức files.listLabels.
  • FILE_ID: fileId của tệp có nhãn sửa đổi.