标签、字段和选项在生活中会经历特定状态。此外,标签可能有不同的修订版本。下图显示了标签生命周期(包括修订):
- 创建标签 (
create()
) - 创建标签并将其作为revision_id=1
存储在数据库中。标签的状态为UNPUBLISHED_DRAFT
。在此状态下:- 用户无法查看标签
- 用户无法将标签应用于云端硬盘内容。
- (可选)更新标签、字段或选择 (
delta()
) - 每次更新(即使发布之前)都会存储在数据库中,并且标签的修订版本会递增。 - 发布标签 (
publish()
) - 标签的状态为PUBLISHED
,用户可以应用该标签。发布标签将递增其修订版本。 - (可选)更新标签、字段或选择 (
delta()
) - 标签、字段或选项会更新,并作为草稿标签存储在数据库中。标签的状态为PUBLISHED
和hasUnpublishedChanges=true
,表示有草稿更改,但用户无法查看这些更改。每次更新都会递增标签的修订版本。 - (可选)发布标签 (
publish()
) - 如果有,系统会发布最新的草稿。该标签的状态为PUBLISHED
,用户可以应用该标签。发布标签会递增其版本。 - 停用标签 (
disable()
) - 虽然用户可以通过 API 应用标签,但其状态为DISABLED
。不过,已停用的标签不会显示在界面中,除非将其配置为显示。弃用标签会递增其修订版本。 - 启用标签 (
enable()
) - 标签会恢复为PUBLISHED
状态,用户可以应用该标签。发布标签将递增其修订版本。 - 删除标签 (
delete()
) - 标签的状态为DELETED
,无法应用。已删除的标签最终会被完全清除。
请务必强调,每次对标签的更新都会递增标签的修订版本。而且,如果标签已发布,则在 n 次更新后再次发布该标签意味着其已发布的修订版本号为修订版本号 + n + 1 次连续更新。nn