이 페이지에서는 라벨과 관련된 다음 작업을 수행하는 방법을 설명합니다.
- 라벨 사용 중지
- 라벨 사용 설정
- 라벨 삭제
라벨 사용 중지
라벨을 사용 중지하면 현재 게시된 버전에 따라 게시된 새 버전이 사용 중지됩니다. 초안 버전이 있으면 사용 중지된 새 초안 버전이 최신 초안 버전을 기반으로 생성됩니다. 이전 초안 버전은 삭제됩니다. 자세한 내용은 라벨 수명 주기를 참고하세요.
사용 중지해도 사용자는 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);
});
라벨의 State는 DISABLED이며 라벨의 버전 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);
});
라벨의 State는 PUBLISHED이며 라벨의 버전 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);
});
라벨의 State는 DELETED이며 라벨의 버전 ID가 증가합니다. 라벨은 적용할 수 없으며 삭제된 라벨은 결국 삭제됩니다. 자세한 내용은 라벨 수명 주기를 참고하세요.