標籤生命週期
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
標籤、領域和選項在生活中會經歷特定狀態。
此外,標籤也可能有不同的修訂版本。下圖顯示
標籤的生命週期,包括修訂版本
圖 3. 標籤的生命週期
- 建立標籤 (
create()
):建立標籤並儲存在
revision_id=1
格式。標籤的狀態為 UNPUBLISHED_DRAFT
。
處於這個狀態時:
- 使用者無法查看標籤
- 使用者無法將標籤套用至雲端硬碟項目。
- (選用) 更新標籤、欄位或選項 (
delta()
) - 每次更新
會將標籤儲存在資料庫中
就必須遞增
- 發布標籤 (
publish()
) - 標籤的狀態為 PUBLISHED
。
使用者才能套用標籤發布標籤會遞增修訂版本。
- (選用) 更新標籤、欄位或選項 (
delta()
):標籤、
或選項更新後,就會以草稿標籤的形式儲存在資料庫中。
標籤的狀態為 PUBLISHED
,hasUnpublishedChanges=true
代表意義
有草稿變更,但使用者無法存取。每次更新
遞增標籤修訂版本。
- (選用) 發布標籤 (
publish()
):如果有的話,就是最新的
已發布草稿。標籤的狀態為 PUBLISHED
,使用者可以
並套用標籤發布標籤會遞增版本。
- 停用標籤 (
disable()
):標籤處於 DISABLED
狀態
但使用者可以透過 API 套用標籤但停用的標籤
不會顯示在 UI 中。淘汰標籤
遞增修訂版本。
- 啟用標籤 (
enable()
):標籤會回傳至 PUBLISHED
狀態
以便使用者套用標籤發布標籤會遞增修訂版本。
- 刪除標籤 (
delete()
) - 標籤的狀態為 DELETED
。
無法套用系統最終會清除已刪除的標籤。
請特別注意,每次更新標籤都會
修訂版本。如果標籤已發布
n 次更新後,代表其發布的修訂版本編號為 n + 1 鍵
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-08 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{
"last_modified": "上次更新時間:2024-08-08 (世界標準時間)。",
"state": ""
}