标签 是您指定的元数据，可帮助用户整理和查找 Google 云端硬盘中的文件，以及针对这些文件应用政策。Drive Labels API 是一种 RESTful API，可通过将元数据附加到云端硬盘文件来支持业务流程。此 API 的常见用途包括：
将内容分类以遵循信息治理策略—创建 标签来标识敏感内容或需要特殊处理的数据。 例如，您可以创建一个名为“敏感度”的标记标签（包含颜色编码的选项值的标签），其值为“绝密”“机密”和“公开”。
针对云端硬盘中的内容应用政策 \- 创建标签，以便在 云端硬盘内容的整个生命周期内对其进行管理，并确保其遵循 贵组织的记录保留做法。例如，使用标签来管理数据丢失防护 (DLP) 政策，以便无法将“敏感度”标签设置为“绝密”的文件下载到计算机。
挑选和查找文件—创建标签，以便让贵组织中的用户根据标签及其字段查找内容，从而提高贵公司内容的可搜索性。例如，贵组织中的用户可以使用云端硬盘搜索选项来查找需要在特定日期之前签字的所有合同。
下面列出了 Drive Labels API 中使用的常用术语：
- 标签
放置在云端硬盘文件上的结构化元数据。 云端硬盘用户可以为文件分配标签并设置标签字段值。标签由以下部分组成：
- 标签名称
- 标签的资源名称。标签 ID 构成了标签名称的一部分。根据请求的不同，名称的格式为：
labels/{id}或labels/{id}@{revisionId}。如需了解详情，请参阅下文中的 标签修订版本。 - 标签 ID
- 标签的全局唯一标识符。ID 构成了标签名称的一部分，但与名称不同的是，它在修订版本之间保持一致。
标签有以下 2 种样式：
- 标记标签
一种包含
SelectionOptions字段类型的标签，其中包含选项，这些选项可以进行颜色编码以指示 重要性。这是通过badgeConfig设置Properties来完成的。Choice云端硬盘会显示每个文件所选选项的颜色，以便用户清楚了解文件的状态、分类等信息。 例如，“敏感度”标记标签的“绝密”选项可能会以红色显示。您一次只能有一个标记标签。
- 标准标签
一种包含零个或多个 字段类型的标签。标准标签可能包含标签标题（例如“Project Moonshot”），并指示与该项目相关的所有文件。标准标签也可能包含多个结构化字段。例如，标题为“合同”的标签可能包含“公司”“截止日期”“状态”和“签署人”等字段。 每个字段都有特定的类型（文本、日期、选项或用户）。
|
|
- 字段
标签的单个类型化、可设置的组件。一个标签可以关联零个或多个字段。
- 字段类型
- 与 字段 关联的值的数据类型。可配置为文本、整数、日期、用户或选项。如果您使用
ListOptions配置字段，则可以为用户和选项字段设置多个值。选择的类型会影响适用于云端硬盘内容的有效值以及可用的搜索查询选项。
- 选项
用户可以在
SelectionOptions字段中选择的多个选项之一。- 标签类型
所有标签都包含
LabelType。标签分为以下 2 种类型：- 管理员
如需创建和修改管理员拥有的标签，您必须是拥有 “管理标签” 特权的帐号 管理员。
管理员可以与任何用户共享管理员标签，以授予该用户查看这些标签并将其应用于云端硬盘内容的权限。如需修改或读取云端硬盘内容上的标签值，您需要具备以下权限：
修改 - 如需让用户修改与给定标签相关的云端硬盘内容元数据，该用户必须具备相应的权限级别：
- 云端硬盘内容：
EDITOR - 标签：
APPLIER
- 云端硬盘内容：
读取 - 如需让用户读取或搜索与给定标签相关的云端硬盘内容元数据，该用户必须具备相应的权限级别：
- 云端硬盘内容：
READER - 标签：
READER
- 云端硬盘内容：
非管理员用户可以创建共享标签，供其他人应用于云端硬盘内容。团队可以创建和整理自己的标签，供团队内部使用，而无需管理员。
- 标签分类法
用户可以应用于云端硬盘文件的当前配置的标签字段。也称为标签架构。
标签分类法示例：
- 敏感度 - 红色、橙色、黄色、绿色
- 状态 - 尚未开始、草稿、审核中、最终
- 内容类型 - 合同、设计文档、视觉稿
- 部门 - 市场营销、财务、人力资源、销售
- 标签生命周期
标签会经历一个生命周期，包括创建、发布、更新等阶段。随着标签经历生命周期，其 标签修订版本 会递增。如需了解详情，请参阅标签生命周期。
- 标签修订版本
标签的实例。每当创建、更新、发布或废弃标签时，标签修订版本都会递增。
- 草稿修订版本
- 标签当前草稿实例的修订版本号。您可以对标签进行多次更新，每次更新都会递增其草稿修订版本号，而不会影响已发布的修订版本。拥有草稿标签的功能可让您在发布之前测试标签更新。
- 已发布修订版本
- 标签已发布版本的修订版本号。已发布的标签是用户当前可用的标签实例。
相关主题
如需了解如何使用 Google Workspace API 进行开发（包括处理 身份验证和授权），请参阅开始使用 Google Workspace 开发者身份。
如需了解如何配置和运行简单的 Labels API 应用，请尝试 Python 快速入门。