라벨은 사용자가 Google Drive의 파일을 정리하고, 찾고, Google Drive에 정책을 적용하는 데 도움을 주기 위해 정의하는 메타데이터입니다. Drive Labels API는 Drive 파일에 메타데이터를 첨부하여 비즈니스 프로세스를 지원하는 RESTful API입니다. 이 API의 일반적인 용도는 다음과 같습니다.
정보 관리 전략을 준수하도록 콘텐츠 분류 - 특별한 처리가 필요한 민감한 콘텐츠나 데이터를 식별하는 라벨을 만듭니다. 예를 들어 '일급비밀', '기밀', '공개' 값을 사용하여 '민감도'라는 제목의 배지가 있는 라벨 (색상으로 구분된 옵션 값이 있는 라벨)을 만들 수 있습니다.
Drive의 항목에 정책 적용—라벨을 만들어 수명 주기 동안 Drive 콘텐츠를 관리하고 조직의 기록 보관 관행을 준수하는지 확인합니다. 예를 들어 라벨을 사용하여 '민감도' 라벨이 '일급 비밀'으로 설정된 파일을 컴퓨터에 다운로드할 수 없도록 하는 데이터 손실 정책 (DLP)을 관리할 수 있습니다.
파일 선별 및 찾기 - 조직의 사용자가 라벨 및 필드를 기반으로 항목을 찾을 수 있도록 하여 회사 콘텐츠의 검색 가능성을 높이는 라벨을 만듭니다. 예를 들어 조직의 사용자는 Drive 검색 옵션을 사용하여 특정 날짜까지 서명을 기다리는 모든 계약을 찾을 수 있습니다.
다음은 Drive Labels API에서 사용되는 일반적인 용어 목록입니다.
- 라벨
Drive 파일에 배치된 구조화된 메타데이터입니다. Drive 사용자는 파일의 라벨을 할당하고 라벨 필드 값을 설정할 수 있습니다. 라벨은 다음으로 구성됩니다.
- 라벨 이름
- 라벨의 리소스 이름입니다. 라벨 ID는 라벨 이름의 일부를 구성합니다. 요청에 따라 이름은
labels/{id}
또는labels/{id}@{revisionId}
형식입니다. 자세한 내용은 아래의 라벨 버전을 참조하세요. - 라벨 ID
- 라벨의 전역 고유 식별자입니다. ID는 라벨 이름의 일부를 구성하지만 이름과 달리 버전 간에 일관됩니다.
라벨에는 다음 두 가지 스타일이 있습니다.
- 배지가 있는 라벨
중요도를 나타내기 위해 색상으로 지정할 수 있는 choices가 포함된
SelectionOptions
필드 유형의 라벨Choice
의Properties
를 통해badgeConfig
를 설정하면 됩니다.Drive에는 각 파일에 선택된 옵션의 색상이 표시되므로 사용자가 파일의 상태, 분류 등을 명확하게 이해할 수 있습니다. 예를 들어 '민감도' 배지가 있는 라벨의 '일급비밀' 옵션이 빨간색으로 표시될 수 있습니다. 배지가 있는 라벨은 한 번에 하나만 사용할 수 있습니다.
- 표준 라벨
0개 이상의 필드 유형을 포함하는 라벨 표준 라벨에는 'Project Moonshot'과 같은 라벨 제목이 있을 수 있으며 프로젝트와 관련된 모든 파일을 나타냅니다. 표준 라벨에는 구조화된 여러 필드가 있을 수도 있습니다. 예를 들어 '계약'이라는 제목의 라벨에는 '회사', '마감일', '상태', '서명인' 필드가 포함될 수 있습니다. 각 필드는 특정 유형 (텍스트, 날짜, 선택, 사용자)입니다.
- 필드
개별 유형이 지정되고 설정 가능한 라벨의 구성요소입니다. 라벨에는 0개 이상의 필드가 연결될 수 있습니다.
- 필드 유형
- 필드와 연결된 값의 데이터 유형입니다. 텍스트, 정수, 날짜, 사용자 또는 선택 항목으로 구성할 수 있습니다.
ListOptions
로 필드를 구성하는 경우 여러 값으로 사용자 및 선택 필드를 설정할 수 있습니다. 선택한 유형은 Drive 항목에 적용 가능한 유효한 값과 사용 가능한 검색어 옵션에 모두 영향을 줍니다.
- 선택
사용자가
SelectionOptions
필드 내에서 선택할 수 있는 여러 옵션 중 하나입니다.- 라벨 유형
모든 라벨에는
LabelType
가 포함됩니다. 라벨에는 다음 두 가지 유형이 있습니다.- 관리자
관리자 소유의 라벨을 만들고 수정하려면 라벨 관리 권한이 있는 계정 관리자여야 합니다.
관리자는 모든 사용자와 관리자 라벨을 공유하여 해당 사용자에게 Drive 항목을 보고 적용할 수 있는 권한을 부여할 수 있습니다. Drive 항목의 라벨 값을 수정하거나 읽으려면 다음 권한이 필요합니다.
수정—사용자가 지정된 라벨과 관련된 Drive 항목 메타데이터를 수정하려면 사용자에게 적절한 권한 수준이 있어야 합니다.
- 드라이브 항목:
EDITOR
- 라벨:
APPLIER
- 드라이브 항목:
읽기 - 사용자가 지정된 라벨과 관련된 Drive 항목 메타데이터를 읽거나 검색하려면 적절한 권한 수준이 있어야 합니다.
- 드라이브 항목:
READER
- 라벨:
READER
- 드라이브 항목:
관리자가 아닌 사용자는 다른 사용자가 Drive 항목에 적용할 수 있는 공유 라벨을 만들 수 있습니다. 팀은 관리자 없이도 팀 내에서 사용할 자체 라벨을 만들고 구성할 수 있습니다.
- 라벨 분류
사용자가 Drive 파일을 애플리케이션에 적용하는 데 사용할 수 있는 현재 구성된 라벨 필드입니다. 라벨 스키마라고도 합니다.
라벨 분류 예시:
- 민감도—빨간색, 주황색, 노란색, 녹색
- 상태—시작되지 않음, 초안, 검토 중, 최종
- 콘텐츠 유형: 계약서, 디자인 문서, 샘플
- 부서—마케팅, 재무, 인사, 영업
- 라벨 수명 주기
라벨은 생성, 게시, 업데이트 등의 수명 주기를 거칩니다. 라벨이 수명 주기를 거치면 라벨 버전이 증가합니다. 자세한 내용은 라벨 수명 주기를 참조하세요.
- 라벨 버전
라벨의 인스턴스입니다. 라벨이 생성, 업데이트, 게시, 지원 중단될 때마다 라벨 버전이 증가합니다.
- 초안 버전
- 라벨 현재 초안 인스턴스의 버전 번호입니다. 라벨을 여러 번 업데이트할 수 있으며, 업데이트할 때마다 게시된 버전에 영향을 주지 않고 초안 버전 번호가 증가합니다. 초안 라벨이 있으면 게시 전에 라벨 업데이트를 테스트할 수 있습니다.
- 게시된 버전
- 라벨이 게시된 버전의 버전 번호입니다. 게시된 라벨은 사용자가 현재 사용할 수 있는 라벨의 인스턴스입니다.
관련 주제
인증 및 승인 처리를 포함하여 Google Workspace API를 사용한 개발에 대해 자세히 알아보려면 Google Workspace 개발자로 시작하기를 참고하세요.
간단한 Labels API 앱을 구성하고 실행하는 방법은 Python 빠른 시작을 참조하세요.