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