라벨 사용 중지, 사용 설정, 삭제하기

이 문서에서는 라벨과 관련된 다음 작업을 수행하는 방법을 설명합니다.

  • 라벨 사용 중지
  • 라벨 사용 설정
  • 라벨 삭제

라벨 사용 중지

라벨을 사용 중지하면 현재 게시된 버전을 기반으로 사용 중지된 새 게시 버전이 생성됩니다. 초안 버전이 있는 경우 최신 초안 버전을 기반으로 사용 중지된 새 초안 버전이 생성됩니다. 이전 초안 버전은 삭제됩니다. 자세한 내용은 라벨 수명 주기를 참고하세요.

사용 중지된 후에도 사용자는 Google Drive Labels API를 통해 이 라벨을 계속 적용할 수 있습니다. 라벨은 이미 적용된 위치와 검색결과에 계속 표시됩니다. 사용 중지된 라벨은 삭제할 수 있습니다.

게시된 라벨을 사용 중지하려면 disable 리소스에서 labels 메서드를 사용합니다.

다음도 지정해야 합니다.

  • 라벨을 나타내는 labels 리소스입니다. 라벨의 전역 고유 식별자인 name and an id, 가 포함되어 있습니다.

  • 사용자의 관리자 인증 정보를 사용하려면 useAdminAccess 쿼리 매개변수를 true로 설정합니다. 액세스를 허용하기 전에 서버는 사용자에게 필요한 분류 라벨 관리 관리자 권한이 있는지 확인합니다.

다음 코드 샘플은 라벨의 id를 사용하여 올바른 라벨을 사용 중지하는 방법을 보여줍니다.

Python

service.labels().disable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.disable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

ID을(를) 사용 중지할 라벨의 ID로 바꿉니다.

라벨의 State가 DISABLED 이고 라벨의 버전 ID가 증가합니다. 사용자는 Drive Labels API를 통해 라벨을 적용할 수 있습니다. 그러나 사용 중지된 라벨은 UI에 표시되지 않습니다. 단, showInApply 필드가 DisabledPolicy 객체에 구성된 경우는 예외입니다.

라벨 사용 설정

사용 중지된 라벨을 사용 설정하면 게시된 상태로 복원됩니다. 현재 사용 중지된 게시 버전을 기반으로 새 게시 버전이 생성됩니다. 기존 사용 중지된 초안 버전이 있는 경우 해당 초안을 기반으로 새 버전이 생성되고 사용 설정됩니다. 자세한 내용은 라벨 수명 주기를 참고하세요.

사용 중지된 라벨을 사용 설정하려면 enable 메서드를 labels 리소스에서 사용합니다.

다음도 지정해야 합니다.

  • 라벨을 나타내는 labels 리소스입니다. 라벨의 전역 고유 식별자인 name and an id, 가 포함되어 있습니다.

  • 사용자의 관리자 인증 정보를 사용하려면 useAdminAccess 쿼리 매개변수를 true로 설정합니다. 액세스를 허용하기 전에 서버는 사용자에게 필요한 분류 라벨 관리 관리자 권한이 있는지 확인합니다.

다음 코드 샘플은 라벨의 id를 사용하여 올바른 라벨을 사용 설정하는 방법을 보여줍니다.

Python

service.labels().enable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.enable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

ID를 사용 설정할 라벨의 ID로 바꿉니다.

라벨의 State가 PUBLISHED 이고 라벨의 버전 ID가 증가합니다. 사용자는 Drive Labels API를 통해 파일에 라벨을 보고 적용할 수 있습니다.

라벨 삭제

초안 및 사용 중지된 라벨만 삭제할 수 있습니다. 라벨이 삭제되면 사용자가 입력한 모든 필드 값을 비롯해 라벨이 이전에 적용되었던 모든 인스턴스가 영구적으로 삭제되고 해당 Drive 파일에서 삭제됩니다.

라벨을 삭제하려면 먼저 사용 중지한 후 delete 메서드를 labels 리소스에서 사용해야 합니다.

다음도 지정해야 합니다.

  • 라벨을 나타내는 labels 리소스입니다. 라벨의 전역 고유 식별자인 name and an id, 가 포함되어 있습니다.

  • 사용자의 관리자 인증 정보를 사용하려면 useAdminAccess 쿼리 매개변수를 true로 설정합니다. 액세스를 허용하기 전에 서버는 사용자에게 필요한 분류 라벨 관리 관리자 권한이 있는지 확인합니다.

다음 코드 샘플은 라벨의 id를 사용하여 올바른 라벨을 삭제하는 방법을 보여줍니다.

Python

response = service.labels().delete(
    name='labels/ID',
    useAdminAccess=True
).execute()

Node.js

service.labels.delete({
  name: 'labels/ID',
  useAdminAccess: true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

ID를 삭제할 라벨의 ID로 바꿉니다.

라벨의 State가 DELETED 이고 라벨의 버전 ID가 증가합니다. 라벨을 적용할 수 없으며 삭제된 라벨은 결국 삭제됩니다. 자세한 내용은 라벨 수명 주기를 참고하세요.