Drive Labels API 개요

라벨 은 사용자가 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는 라벨 이름의 일부를 구성하지만 이름과 달리 버전 간에 일관됩니다.

라벨에는 두 가지 스타일이 있습니다.

배지가 있는 라벨

중요도를 나타내기 위해 색상으로 구분할 수 있는 선택항목이 포함된 SelectionOptions 필드 유형의 라벨입니다. 이는 badgeConfig 의 Properties를 통해 Choice를 설정하여 수행됩니다.

Drive는 각 파일에 대해 선택한 옵션의 색상을 표시하므로 사용자는 파일의 상태, 분류 등을 명확하게 이해할 수 있습니다. 예를 들어 '민감도' 배지가 있는 라벨의 '최고 기밀' 옵션이 빨간색으로 표시될 수 있습니다. 배지가 있는 라벨은 한 번에 하나만 사용할 수 있습니다.

표준 라벨

0개 이상의 필드 유형이 포함된 라벨입니다. 표준 라벨에는 'Project Moonshot'과 같은 라벨 제목이 있을 수 있으며 프로젝트와 관련된 모든 파일을 나타낼 수 있습니다. 표준 라벨에는 여러 구조화된 필드가 있을 수도 있습니다. 예를 들어 '계약'이라는 제목의 라벨에는 '회사', '기한', '상태', '서명자' 필드가 포함될 수 있습니다. 각 필드는 특정 유형 (텍스트, 날짜, 선택항목 또는 사용자)입니다.

필드

라벨의 개별 유형이 지정되고 설정 가능한 구성요소입니다. 라벨에는 0개 이상의 필드가 연결될 수 있습니다.

필드 유형: 필드 와 연결된 값의 데이터 유형입니다. 텍스트, 정수, 날짜, 사용자 또는 선택항목으로 구성할 수 있습니다. ListOptions로 필드를 구성하면 여러 값으로 사용자 및 선택항목 필드를 설정할 수 있습니다. 선택한 유형은 Drive 항목에 적용할 수 있는 유효한 값과 사용 가능한 검색어 옵션에 모두 영향을 미칩니다.

선택항목

사용자가 SelectionOptions 필드 내에서 선택할 수 있는 여러 옵션 중 하나입니다.

라벨 유형

모든 라벨에는 LabelType이 포함됩니다. 라벨에는 다음 두 가지 유형이 있습니다.

관리

관리자가 소유한 라벨을 만들고 수정하려면 라벨 관리 권한이 있는 계정 관리자여야 합니다. 라벨 관리 권한이 있는 계정 관리자여야 합니다.

관리자는 관리 라벨을 모든 사용자와 공유하여 해당 사용자에게 Drive 항목을 보고 적용할 수 있는 기능을 부여할 수 있습니다. Drive 항목에서 라벨 값을 수정하거나 읽으려면 다음 권한이 필요합니다.

수정: 사용자가 특정 라벨과 관련된 Drive 항목 메타데이터를 수정하려면 사용자에게 적절한 권한 수준이 있어야 합니다.
- Drive 항목: EDITOR
- 라벨: APPLIER
읽기: 사용자가 특정 라벨과 관련된 Drive 항목 메타데이터를 읽거나 검색하려면 사용자에게 적절한 권한 수준이 있어야 합니다.
- Drive 항목: READER
- 라벨: READER

공유

관리자가 아닌 사용자는 다른 사용자가 Drive 항목에 적용할 수 있는 공유 라벨을 만들 수 있습니다. 팀은 관리자가 없어도 팀 내에서 사용할 라벨을 만들고 정리할 수 있습니다.

라벨 분류

현재 구성된 라벨 필드를 사용자가 Drive 파일에 적용할 수 있습니다. 라벨 스키마라고도 합니다.

라벨 분류의 예는 다음과 같습니다.

민감도: 빨간색, 주황색, 노란색, 녹색
상태: 시작되지 않음, 초안, 검토 중, 최종
콘텐츠 유형: 계약, 설계 문서, 샘플
부서: 마케팅, 재무, 인사, 영업

라벨 수명 주기

라벨은 생성, 게시, 업데이트 등의 수명 주기를 거칩니다. 라벨이 수명 주기를 거치면서 라벨 버전 이 증가합니다. 자세한 내용은 라벨 수명 주기를 참고하세요.

라벨 버전

라벨의 인스턴스입니다. 라벨이 생성, 업데이트, 게시 또는 지원 중단될 때마다 라벨 버전이 증가합니다.

초안 버전: 라벨의 현재 초안 인스턴스의 버전 번호입니다. 게시된 버전에 영향을 미치지 않고 라벨을 여러 번 업데이트할 수 있으며, 업데이트할 때마다 초안 버전 번호가 증가합니다. 초안 라벨을 사용하면 게시하기 전에 라벨 업데이트를 테스트할 수 있습니다.
게시된 버전: 라벨의 게시된 버전의 버전 번호입니다. 게시된 라벨은 현재 사용자에게 제공되는 라벨의 인스턴스입니다.

Drive Labels API 개요 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

관련 주제

Drive Labels API 개요