Drive Labels API 概览

标签是您定义的元数据,用于帮助用户整理和查找 Google 云端硬盘中的文件,以及将政策应用于文件。Drive Labels API 是一个 RESTful API,支持通过将元数据附加到云端硬盘文件来支持业务流程。此 API 的常见用途包括:

  • 对内容进行分类以遵循信息治理策略 - 创建标签以识别敏感内容或需要特殊处理的数据。例如,您可以创建一个名为“敏感度”且值为“绝密”“机密”和“公开”的标记标签(选项值用颜色标识的标签)。

  • 对云端硬盘中的内容应用政策 - 创建标签以管理云端硬盘内容的整个生命周期,并确保其遵循贵组织的记录保留做法。例如,使用标签来管理数据丢失政策 (DLP),确保将“敏感度”标签设置为“绝密”的文件无法下载到计算机。

  • 挑选和查找文件 - 创建标签,让组织中的人员根据标签及其字段查找内容,从而提高公司内容的可搜索性。例如,贵组织中的某人可以使用云端硬盘搜索选项查找在特定日期之前等待签字的所有合同。

下面列出了 Drive Labels API 中使用的常用术语:

标签

云端硬盘文件中的结构化元数据。 云端硬盘用户可以为文件分配标签和设置标签字段值。标签由以下部分组成:

标签名称
标签的资源名称。标签 ID 构成标签名称的一部分。根据请求的不同,名称会采用 labels/{id}labels/{id}@{revisionId} 格式。如需了解详情,请参阅下面的标签修订版本
标签 ID
标签的全局唯一标识符。该 ID 构成了标签名称的一部分,但与名称不同,它在修订版本之间保持一致。

标签有两种样式:

带标记的标签

具有 SelectionOptions 字段类型的标签,其中包含可进行颜色编码以指示重要性的选择。可以通过 ChoiceProperties 设置 badgeConfig 来实现。

云端硬盘会为每个文件显示所选选项的颜色,以便用户清楚地了解文件的状态、分类等。例如,“敏感度”标记标签的“绝密”选项可能显示为红色。您一次只能有一个标记标签。

标准标签

包含零个或多个字段类型的标签。标准标签可能具有一个标签标题(例如“Project Moonshot”),并指示与项目相关的所有文件。标准标签也可能有多个结构化字段。例如,标题为“合同”的标签可能包含“公司”“截止日期”“状态”和“签署者”字段。每个字段都有特定类型(文本、日期、选择或用户)。

带标记的标签的示意图。
图 1.带标记的标签
标准标签示意图。
图 2.标准标签
字段

标签的单个可设置的可设置组件。一个标签可以有零个或多个与其关联的字段。

字段类型
字段关联的值的数据类型。可配置为文本、整数、日期、用户或选项。如果您用 ListOptions 配置该字段,可以为用户和选择字段设置多个值。所选类型会影响适用于云端硬盘内容的有效值和可用的搜索查询选项。
选择

用户可以从 SelectionOptions 字段中选择的若干选项之一。

标签类型

所有标签都包含一个 LabelType。标签有两种类型:

管理

如需创建和修改管理员拥有的标签,您必须是拥有管理标签权限的帐号管理员。

管理员可以与任何用户共享管理员标签,授予该用户查看这些标签并将其应用于云端硬盘内容的权限。如需修改或读取云端硬盘内容的标签值,需要以下权限:

  • 修改 - 如需允许用户修改与给定标签相关的云端硬盘内容元数据,用户必须具备适当的权限级别:

    • 云端硬盘内容:EDITOR
    • 标签:APPLIER
  • 读取 - 要想读取或搜索与给定标签相关的云端硬盘内容元数据,用户必须拥有适当的权限级别:

    • 云端硬盘内容:READER
    • 标签:READER
Shared

非管理员用户可以创建共享标签,供其他人应用于云端硬盘内容。团队可以创建和整理自己的标签,以便在团队中使用,而无需管理员。

标签类目

当前已配置的标签字段,可供用户应用于云端硬盘文件。也称为标签架构。

标签分类示例:

  • 灵敏度 - 红色、橙色、黄色、绿色
  • 状态 - 未开始、草稿、审核中、最终
  • 内容类型 - 合同、设计文档、模型
  • 部门 - 营销、财务、人力资源、销售
标签生命周期

标签会经历一个生命周期,在其中创建、发布、更新标签,等等。当标签经历整个生命周期时,其标签修订版本会递增。如需了解详情,请参阅标签生命周期

标签修订版本

标签的实例。每当创建、更新、发布或弃用标签时,标签修订版本都会递增。

修订版本草稿
标签当前草稿实例的修订版本号。您可以对标签进行多次更新,每次更新递增其草稿修订版本号,而不会影响已发布的修订版本。借助草稿标签,您可以在发布之前测试标签更新。
已发布的修订版本
标签的已发布版本的修订版本号。已发布的标签是用户当前可用的标签实例。