라벨 만들기 및 게시

이 페이지에서는 라벨을 만들고 게시하는 방법을 설명합니다.

라벨 만들기

라벨을 만들려면 create 컬렉션에서 labels 메서드를 사용합니다. 라벨에는 선택적으로 하나 이상의 Fields가 포함될 수 있습니다.

다음도 지정해야 합니다.

  • A LabelType.

  • property 메서드를 통한 라벨 title

  • useAdminAccess는 사용자의 관리자 사용자 인증 정보를 사용하기 위해 true입니다. 서버는 액세스를 허용하기 전에 사용자에게 '라벨 관리' 권한이 있는 관리자인지 확인합니다.

이 예에서는 지정된 제목과 SelectionOptions Field가 하나인 표준 관리자 라벨을 만듭니다.Choices

Python

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

Node.js

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

service.labels.create({
  'resource': label,
  'use_admin_access': true
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

라벨은 UNPUBLISHED_DRAFT State에서 생성됩니다. 파일에서 사용하고 사용자에게 표시되려면 PUBLISHED여야 합니다. 자세한 내용은 라벨 수명 주기를 참고하세요.

라벨 한도

라벨을 만들고 적용할 때는 다음 한도가 적용됩니다.

  • 표준 라벨: 150개
  • 라벨당 필드: 10개

라벨에서 필드 사용하기

Field Type 사용자가 할 수 있는 작업 형식 고려사항 및 한도
SelectionOptions 목록에서 하나 이상의 옵션 선택 지원되는 최대 옵션 수는 200개입니다.
파일의 최대 선택 항목 수는 ListOptions에 구성된 대로 10개입니다.
IntegerOptions 숫자 값 입력 정수만 지원됩니다.
DateOptions 달력 날짜 선택 (선택사항) Date format을 'Long: Month DD, YYYY' 또는 'Short: MM/DD/YY'로 설정할 수 있습니다.
TextOptions 텍스트 상자에 텍스트 입력 지원되는 최대 문자 수는 100자입니다.
UserOptions Google Workspace 연락처에서 하나 이상의 사용자 선택 파일의 최대 사용자 항목 수는 ListOptions에 구성된 대로 10개입니다.

라벨 게시하기

Labels API를 사용하면 초안 라벨이 완료된 후 게시할 수 있습니다.

라벨을 게시하려면 publish 메서드를 사용하고 다음을 지정합니다.

  • 모든 라벨을 나타내는 라벨 리소스 입니다. 라벨의 전역적으로 고유한 식별자인 리소스 Name 및 ID가 포함되어 있습니다.

  • useAdminAccess는 사용자의 관리자 사용자 인증 정보를 사용하기 위해 true입니다. 서버는 액세스를 허용하기 전에 사용자에게 '라벨 관리' 권한이 있는 관리자인지 확인합니다.

이 예에서는 ID를 사용하여 올바른 라벨을 식별하고 게시합니다.

Python

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

Node.js

service.labels.publish({
  '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가 증가합니다. 그러면 라벨이 사용자에게 표시되고 파일에 적용할 수 있습니다. 자세한 내용은 라벨 수명 주기를 참고하세요.

라벨 게시 시 제약 조건

  • 게시된 라벨은 원래 초안 상태로 돌아갈 수 없습니다. 자세한 내용은 라벨 수명 주기를 참고하세요.

  • 라벨을 게시하면 새로 게시된 버전이 생성됩니다. 이전의 모든 초안 버전은 삭제됩니다. 이전에 게시된 버전은 유지되지만 필요에 따라 자동 삭제될 수 있습니다.

  • 게시된 후에는 일부 변경사항이 더 이상 허용되지 않습니다. 일반적으로 이는 라벨과 관련된 기존 메타데이터를 무효화하거나 새로운 제한사항을 트리거하는 변경사항이 거부됨을 의미합니다. 예를 들어 라벨이 게시된 후에는 라벨에 대한 다음 변경사항이 허용되지 않습니다.

    • 라벨이 직접 삭제됩니다. (먼저 사용 중지한 후 삭제해야 합니다.)
    • Field.FieldType이 변경됩니다.
    • 필드 유효성 검사 옵션 업데이트로 인해 이전에 허용된 항목이 거부됩니다.
    • 최대 항목 수가 감소합니다.