파일의 라벨 필드 설정 해제

이 페이지에서는 단일 Google Drive 파일에서 라벨 Field을 설정 해제하는 방법을 설명합니다.

파일 라벨을 설정 해제하여 파일에서 메타데이터를 삭제하려면 files.modifyLabels 메서드를 사용합니다. 요청 본문에는 파일의 라벨 집합을 수정하는 ModifyLabelsRequest의 인스턴스가 포함됩니다. 요청에는 원자적으로 적용되는 여러 수정사항이 포함될 수 있습니다. 즉, 수정사항이 유효하지 않으면 전체 업데이트가 실패하고 (잠재적으로 종속된) 변경사항이 적용되지 않습니다.

ModifyLabelsRequest에는 파일의 라벨을 수정한 LabelModification 인스턴스가 포함되어 있습니다. 라벨 필드의 수정사항인 FieldModification 인스턴스도 포함될 수 있습니다. 필드의 값을 설정 해제하려면 FieldModification.unsetValues를 True로 설정합니다.

성공하면 응답 본문에 요청에 의해 추가되거나 업데이트된 라벨이 포함됩니다. 이러한 객체는 Label 유형의 modifiedLabels 객체 내에 존재합니다.

예

다음 코드 샘플은 fieldId 및 labelId를 사용하여 연결된 fileId의 필드 값을 설정 해제하는 방법을 보여줍니다. 예를 들어 라벨에 텍스트 필드와 사용자 필드가 모두 포함된 경우 텍스트 필드의 설정을 해제하면 라벨에서 텍스트 필드가 삭제되지만 사용자 필드는 그대로 유지됩니다. 라벨을 삭제하면 라벨과 연결된 텍스트 필드와 사용자 필드가 모두 삭제됩니다. 자세한 내용은 파일에서 라벨 삭제를 참고하세요.

자바

LabelFieldModification fieldModification =
  new LabelFieldModification().setFieldId("FIELD_ID").setUnsetValues(true);

ModifyLabelsRequest modifyLabelsRequest =
  new ModifyLabelsRequest()
      .setLabelModifications(
          ImmutableList.of(
              new LabelModification()
                .setLabelId("LABEL_ID")
                .setFieldModifications(ImmutableList.of(fieldModification))));

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

Python

field_modification = {'fieldId':'FIELD_ID','unsetValues':True}
label_modification = {'labelId':'LABEL_ID', 'fieldModifications':[field_modification]}

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

Node.js

/**
* Unset a label with a field on a Drive file
* @return{obj} updated label data
**/
async function unsetLabelField() {
  // 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 fieldModification = {
    'fieldId': 'FIELD_ID',
    'unsetValues': True,
  };
  const labelModification = {
    'labelId': 'LABEL_ID',
    'fieldModifications': [fieldModification],
  };
  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;
  }
}

다음을 바꿉니다.

  • FIELD_ID: 수정할 필드의 fieldId입니다. fieldId를 찾으려면 Google Drive Labels API를 사용하여 라벨을 가져옵니다.
  • LABEL_ID: 수정할 라벨의 labelId입니다.
  • FILE_ID: 라벨이 수정된 파일의 fileId입니다.