라벨은 사용자가 Google Drive의 파일을 정리하고, 찾고, 정책을 적용할 수 있도록 정의하는 메타데이터입니다. Drive Labels API는 Drive 파일에 메타데이터를 연결하여 비즈니스 프로세스를 지원하는 RESTful API입니다. 이 API의 일반적인 용도는 다음과 같습니다.
정보 관리 전략에 따라 콘텐츠 분류: 민감한 콘텐츠 또는 특별 처리가 필요한 데이터를 식별하는 라벨을 만듭니다.
예를 들어 '민감도'라는 배지가 있는 라벨 (색상 코드가 지정된 옵션 값이 있는 라벨)을 만들고 값으로 '최고 기밀', '기밀', '공개'를 지정할 수 있습니다.
Drive의 항목에 정책 적용: 수명 주기 동안 Drive 콘텐츠를 관리하고 조직의 기록 보관 관행을 준수하도록 라벨을 만듭니다. 예를 들어 라벨을 사용하여 '민감도' 라벨이 '최고 기밀'로 설정된 파일을 컴퓨터에 다운로드할 수 없는 데이터 손실 방지 (DLP) 정책을 관리할 수 있습니다.
파일 선별 및 찾기: 조직의 사용자가 라벨 및 필드를 기반으로 항목을 찾을 수 있도록 라벨을 만들어 회사 콘텐츠의 검색 가능성을 높입니다. 예를 들어 조직 내 사용자는 Drive 검색 옵션을 사용하여 특정 날짜까지 서명을 대기 중인 모든 계약서를 찾을 수 있습니다.
Drive는 각 파일에 대해 선택한 옵션의 색상을 표시하므로 사용자가 파일의 상태, 분류 등을 명확하게 이해할 수 있습니다.
예를 들어 '민감도' 배지가 있는 라벨의 '최고 기밀' 옵션이 빨간색으로 표시될 수 있습니다. 배지가 있는 라벨은 한 번에 하나만 사용할 수 있습니다.
표준 라벨
0개 이상의 필드 유형이 포함된 라벨입니다. 표준 라벨에는 'Project Moonshot'과 같은 라벨 제목이 있을 수 있으며 프로젝트와 관련된 모든 파일을 나타냅니다. 표준 라벨에는 여러 구조화된 필드가 있을 수도 있습니다. 예를 들어 제목이 '계약'인 라벨에는 '회사', '마감일', '상태', '서명자' 필드가 포함될 수 있습니다. 각 필드는 특정 유형 (텍스트, 날짜, 선택, 사용자)입니다.
라벨의 개별 유형이 지정되고 설정 가능한 구성요소입니다. 라벨에는 연결된 필드가 0개 이상 있을 수 있습니다.
필드 유형
field와 연결된 값의 데이터 유형입니다. 텍스트, 정수, 날짜, 사용자 또는 선택으로 구성할 수 있습니다. ListOptions로 필드를 구성하면 여러 값으로 사용자 및 선택 필드를 설정할 수 있습니다. 선택한 유형은 Drive 항목에 적용할 수 있는 유효한 값과 사용 가능한 검색어 옵션에 모두 영향을 미칩니다.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Drive Labels API overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive Labels API is a RESTful API that\nsupports business processes by attaching metadata to your Drive\nfiles. Common uses for this API are:\n\n- **Classify content to follow an information governance strategy**---Create a\n label to identify sensitive content or data that requires special handling.\n For example, you might create a badged label (a label with color-coded\n option values) titled \"Sensitivity\" with the values of \"Top Secret,\"\n \"Confidential,\" and \"Public.\"\n\n- **Apply policy to items in Drive**---Create labels to manage\n Drive content throughout its lifecycle and ensure it adheres\n to your organization's record keeping practices. For example, use labels to\n manage a data loss policy (DLP) whereby files with a \"Sensitivity\" label set\n to \"Top Secret\" can't be downloaded to a computer.\n\n- **Curate and find files**---Create labels to increase searchability of your\n company's content by letting people in your organization find items based on\n labels and their fields. For example, someone in your organization could use\n Drive search options to find all contracts awaiting signature\n by a specific date.\n\nBelow is a list of common terms used in the Drive Labels API:\n\n[*Label*](/workspace/drive/labels/reference/rest/v2/labels#resource:-label)\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values for\n files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* makes up part of the\n Label name. Depending on the request, the name is in the form of either:\n `labels/{id}` or `labels/{id}@{revisionId}`. For more information, see\n [Label revision](#revision) below.\n\n *Label ID*\n : A globally unique identifier for the label. The ID makes up part of the\n label name, but unlike the name, it's consistent between revisions.\n\n There are 2 styles of labels:\n\n *Badged label*\n\n : A label with a\n [`SelectionOptions`](/workspace/drive/labels/reference/rest/v2/labels#selectionoptions)\n field type containing *choices* that can be color-coded to indicate\n importance. This is done by setting\n [`badgeConfig`](/workspace/drive/labels/reference/rest/v2/labels#BadgeConfig)\n through the\n [`Properties`](/workspace/drive/labels/reference/rest/v2/labels#properties_1) of a\n [`Choice`](/workspace/drive/labels/reference/rest/v2/labels#choice).\n\n Drive displays the color of the chosen option for each file so users\n clearly understand the status, classification, and so on, of the file.\n For example, the \"Top Secret\" option for the \"Sensitivity\" badged label\n might display in red. You can only have one badged label at a time.\n\n *Standard label*\n\n : A label containing zero or more *field type*s. A standard label might\n have a label title, such as \"Project Moonshot,\" and indicate all files\n related to the project. A standard label might also have several\n structured fields. For example, a label with the title \"Contract\" might\n contain the fields for \"Company,\" \"Due Date,\" \"Status,\" and\n \"Signatories.\" Each field is of a specific type (text, date,\n selection, or user).\n\n|----------------------------|------------------------------|\n| **Figure 1.** Badged label | **Figure 2.** Standard label |\n\n[*Field*](/workspace/drive/labels/reference/rest/v2/labels#field)\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it.\n\n *Field type*\n : The data type of the value associated with the *field* . Configurable as\n text, integer, date, user, or selection. If you configure the field with\n `ListOptions`, you can set the user and selection fields with multiple\n values. The type chosen impacts both the valid values applicable to\n Drive items and the search query options available.\n\n[*Choice*](/workspace/drive/labels/reference/rest/v2/labels#choice)\n\n: One of several options a user can choose from within a `SelectionOptions`\n field.\n\n[*Label type*](/workspace/drive/labels/reference/rest/v2/labels#labeltype)\n\n: All labels include a `LabelType`. There are 2 types of labels:\n\n *Admin*\n\n : To create and edit admin-owned labels, you must be an account\n administrator with the\n [Manage Labels](https://support.google.com/a/answer/1219251#drive_and_docs)\n privilege.\n\n Admins can share admin labels with any user to grant that user the\n ability to view and apply them to Drive items. Modifying or reading\n label values on Drive items requires the following permissions:\n\n - Modifying---For a user to modify the Drive item metadata related to a\n given label, the user must have the appropriate permission levels:\n\n - Drive item: `EDITOR`\n - Label: `APPLIER`\n - Reading---For a user to read or search for the Drive item metadata\n related to a given label, the user must have the appropriate\n permission levels:\n\n - Drive item: `READER`\n - Label: `READER`\n\n *Shared*\n\n : Non-administrator users can create shared labels that others can apply\n to Drive items. Teams can create and organize their own labels for use\n within the team without requiring an administrator.\n\n | **Note:** Shared labels are only available in a closed beta that isn't currently accepting new customers.\n\n*Label taxonomy*\n\n: The currently configured label fields available to users for application to\n Drive files. Also known as the label schema.\n\n Example label taxonomies:\n\n - Sensitivity---Red, Orange, Yellow, Green\n - Status---Not Started, Draft, In Review, Final\n - Content type---Contract, Design Doc, Mockup\n - Department---Marketing, Finance, Human Resources, Sales\n\n[*Label lifecycle*](/workspace/drive/labels/reference/rest/v2/labels#lifecycle)\n\n: Labels go through a lifecycle where they're created, published, updated, and\n so on. As a label makes it through the lifecycle, its *label revision* is\n incremented. For more information, see [Label lifecycle](/workspace/drive/labels/guides/label-lifecycle).\n\n*Label revision*\n\n: An instance of the label. Anytime a label is created, updated, published, or\n deprecated, the label revision increments.\n\n *Draft revision*\n : The revision number of the current draft instance of the label. You can\n make several updates to a label, each incrementing its draft revision\n number, without affecting the published revision. The ability to have\n draft labels lets you test label updates before publishing.\n\n *Published revision*\n : The revision number of the published version of a label. The published\n label is the instance of the label currently available to users.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Get started as a\n Google Workspace\n developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Labels API app, try the\n [Python quickstart](/workspace/drive/labels/quickstart/python)."]]
