Drive Labels API 개요

라벨은 사용자가 정리, 검색, 적용하는 데 도움이 되도록 정의하는 메타데이터입니다. Google Drive의 파일에 대한 정책을 준수해야 합니다. Drive Labels API는 Drive에 메타데이터를 첨부하여 비즈니스 프로세스 지원 할 수 있습니다. 이 API의 일반적인 용도는 다음과 같습니다.

  • 정보 관리 전략을 준수하도록 콘텐츠 분류: 라벨을 사용하여 특별한 처리가 필요한 민감한 콘텐츠나 데이터를 식별합니다. 예를 들어, 배지가 있는 라벨 (색상이 구분된 라벨)을 만들 수 옵션 값)을 '일급비밀'의 값으로 "기밀" '공개'를 선택합니다

  • Drive의 항목에 정책 적용: 관리할 라벨을 만듭니다. 수명 주기 전반에 걸쳐 콘텐츠를 만들고 정책을 준수하도록 합니다. 조직의 기록 보관 관행에 영향을 미칩니다. 예를 들어 라벨을 사용하여 데이터 손실 정책 (DLP) 관리 라벨 세트 '일급비밀'로 변경 컴퓨터에 다운로드할 수 없습니다.

  • 파일 선별 및 찾기: 라벨을 만들어 파일의 검색 가능성을 높일 수 있습니다. 조직의 사용자가 특정 회사와 관련된 문서를 찾을 때 라벨을 지정합니다 예를 들어 조직의 누군가가 Drive 검색 옵션을 사용하여 서명 대기 중인 모든 계약을 찾으세요 확인할 수 있습니다.

다음은 Drive Labels API에서 사용되는 일반적인 용어 목록입니다.

라벨

Drive 파일에 배치된 구조화된 메타데이터입니다. Drive 사용자는 다음에 대해 라벨을 할당하고 라벨 필드 값을 설정할 수 있습니다. 할 수 있습니다. 라벨은 다음으로 구성됩니다.

라벨 이름
라벨의 리소스 이름입니다. 라벨 ID는 라벨 이름입니다. 요청에 따라 이름은 다음 형식 중 하나입니다. labels/{id} 또는 labels/{id}@{revisionId} 자세한 내용은 라벨 버전은 아래를 참조하세요.
라벨 ID
라벨의 전역 고유 식별자입니다. ID는 이름과 달리 버전 간에 일관됩니다.

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

배지가 있는 라벨

인코더-디코더 SelectionOptions 나타내기 위해 색상으로 표시할 수 있는 choices가 포함된 필드 유형입니다. 중요도가 높습니다. 이렇게 하려면 badgeConfig 를 통해 Properties / Choice:

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

표준 라벨

0개 이상의 필드 유형을 포함하는 라벨 표준 라벨은 'Project Moonshot'과 같은 라벨 제목이 있고 모든 파일을 표시하고 프로젝트 관련 질문입니다 또한 표준 라벨에는 구조화된 필드를 사용합니다 예를 들어 제목이 '계약'인 라벨은 예상 'Company'(회사), "마감일" '상태' 및 "서명인." 각 필드는 특정 유형 (텍스트, 날짜, 선택할 수 있습니다.

배지가 있는 라벨 다이어그램
그림 1. 배지가 있는 라벨
표준 라벨 다이어그램
그림 2. 표준 라벨
필드

개별 유형이 지정되고 설정 가능한 라벨의 구성요소입니다. 라벨에는 0 또는 관련 필드가 더 많아집니다.

필드 유형
필드와 연결된 값의 데이터 유형입니다. 다음으로 구성 가능 텍스트, 정수, 날짜, 사용자 또는 선택입니다. 이 필드를 ListOptions를 사용하는 경우 사용자 및 선택 필드를 여러 값으로 설정할 수 있습니다. 값으로 사용됩니다. 선택한 유형은 Drive 항목 및 사용 가능한 검색어 옵션
선택

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

라벨 유형

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

관리

관리자 소유의 라벨을 만들고 수정하려면 계정이어야 합니다. 관리자에게 라벨 관리 할 수 있습니다

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

  • 수정: 사용자가 사용자에게 적절한 권한 수준이 있어야 합니다.

    • 드라이브 항목: EDITOR
    • 라벨: APPLIER
  • 읽기 작업: 사용자가 Drive 항목 메타데이터를 읽거나 검색할 수 있습니다. 라벨이 지정된 경우 사용자에게 권한 수준:

    • 드라이브 항목: READER
    • 라벨: READER
Shared

관리자가 아닌 사용자도 다른 사용자가 적용할 수 있는 공유 라벨을 만들 수 있습니다. 드라이브 항목으로 이동합니다. 팀에서 사용할 자체 라벨을 만들고 구성할 수 있음 팀 내에서 팀 내에서 업무를 수행할 수 있습니다

라벨 분류

사용자가 애플리케이션에서 사용할 수 있는 현재 구성된 라벨 필드는 Drive 파일 라벨 스키마라고도 합니다.

라벨 분류 예시:

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

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

라벨 버전

라벨의 인스턴스입니다. 라벨이 생성, 업데이트, 게시되거나 라벨 버전이 증가합니다

초안 버전
라벨 현재 초안 인스턴스의 버전 번호입니다. 다음과 같은 작업을 할 수 있습니다. 라벨을 여러 차례 업데이트하여 초안 버전을 증분합니다. 게시된 버전에 영향을 주지 않고 번호를 업데이트할 수 있습니다. 초안 라벨을 사용하면 게시하기 전에 라벨 업데이트를 테스트할 수 있습니다.
게시된 버전
라벨이 게시된 버전의 버전 번호입니다. 게시된 label은 현재 사용자가 사용할 수 있는 라벨의 인스턴스입니다.