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