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

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

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

라벨 사용 중지하기

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

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

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

다음도 지정해야 합니다.

  • 모든 라벨을 나타내는 라벨 리소스입니다. 여기에는 리소스 Name과 라벨의 전역 고유 식별자인 ID이 포함됩니다.

  • useAdminAccess는 사용자의 관리자 사용자 인증 정보를 사용하는 true입니다. 서버는 액세스를 허용하기 전에 사용자가 라벨의 관리자인지 확인합니다.

이 예시에서는 ID를 사용하여 올바른 라벨을 사용 중지합니다.

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

라벨에 DISABLED의 State이 있고 라벨의 버전 ID가 증가합니다. 사용자는 API를 통해 라벨을 적용할 수 있습니다. 하지만 disabledPolicy 메서드의 showInApply 속성이 구성되지 않으면 사용 중지된 라벨이 UI에 표시되지 않습니다.

라벨 사용 설정하기

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

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

다음도 지정해야 합니다.

  • 모든 라벨을 나타내는 라벨 리소스입니다. 여기에는 리소스 Name과 라벨의 전역 고유 식별자인 ID이 포함됩니다.

  • useAdminAccess는 사용자의 관리자 사용자 인증 정보를 사용하는 true입니다. 서버는 액세스를 허용하기 전에 사용자가 라벨의 관리자인지 확인합니다.

이 예시에서는 ID를 사용하여 올바른 라벨을 사용 설정합니다.

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

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

라벨 삭제

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

라벨을 삭제하려면 먼저 라벨을 사용 중지한 다음 delete 메서드를 사용해야 합니다.

다음도 지정해야 합니다.

  • 모든 라벨을 나타내는 라벨 리소스입니다. 여기에는 리소스 Name과 라벨의 전역 고유 식별자인 ID이 포함됩니다.

  • useAdminAccess는 사용자의 관리자 사용자 인증 정보를 사용하는 true입니다. 서버는 액세스를 허용하기 전에 사용자가 라벨의 관리자인지 확인합니다.

이 예시에서는 ID를 사용하여 올바른 라벨을 삭제합니다.

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

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