本頁面說明如何執行下列涉及標籤的工作:
- 停用標籤
- 啟用標籤
- 刪除標籤
停用標籤
停用標籤後,系統會根據目前已發布的修訂版本,建立新的已停用的發布修訂版本。如果有草稿修訂版本,系統會根據最新的草稿修訂版本建立新的停用草稿修訂版本。較舊的草稿修訂版本會遭到刪除。詳情請參閱「標籤生命週期」。
停用後,使用者仍可透過 API 套用這個標籤。但標籤仍會顯示在已套用的位置和搜尋結果中。您可以刪除已停用的標籤。
如要停用已發布的標籤,請在 labels
集合上使用 disable
方法。
您也必須指定下列項目:
代表每個標籤的標籤資源。其中包含資源
Name
和ID
,這是標籤的全域專屬 ID。useAdminAccess
是true
,用於使用使用者的管理員憑證。在允許存取權之前,伺服器會先驗證使用者是否為標籤的管理員。
本範例使用 ID
停用正確的標籤。
Python
service.labels().disable(
name='labels/ID',
body={
'use_admin_access': True
}).execute()
Node.js
service.labels.disable({
'resource': {
'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
標籤具有 DISABLED
的 State
,且標籤的修訂版本 ID 會增加。使用者可以透過 API 套用標籤。不過,除非設定 disabledPolicy
方法的 showInApply
屬性,否則 UI 不會顯示已停用的標籤。
啟用標籤
啟用已停用的標籤後,標籤就會恢復為已發布狀態。這會導致系統根據目前已停用的發布修訂版本,建立新的發布修訂版本。如果有已停用的草稿修訂版本,系統會根據該草稿建立新修訂版本並啟用。詳情請參閱「標籤生命週期」。
如要啟用已停用的標籤,請使用 enable
方法。
您也必須指定下列項目:
代表每個標籤的標籤資源。其中包含資源
Name
和ID
,這是標籤的全域專屬 ID。useAdminAccess
是true
,用於使用使用者的管理員憑證。在允許存取權之前,伺服器會先驗證使用者是否為標籤的管理員。
本範例使用 ID
啟用正確的標籤。
Python
service.labels().enable(
name='labels/ID',
body={
'use_admin_access': True
}).execute()
Node.js
service.labels.enable({
'resource': {
'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
標籤具有 PUBLISHED
的 State
,且標籤的修訂版本 ID 會增加。使用者可以透過 API 查看標籤並套用至檔案。
刪除標籤
您只能刪除草稿和停用的標籤。刪除標籤後,系統會從這些雲端硬碟檔案中永久移除先前套用該標籤的所有例項,包括使用者輸入的任何相應欄位值。
如要刪除標籤,您必須先停用標籤,然後使用 delete
方法。
您也必須指定下列項目:
代表每個標籤的標籤資源。其中包含資源
Name
和ID
,這是標籤的全域專屬 ID。useAdminAccess
是true
,用於使用使用者的管理員憑證。在允許存取權之前,伺服器會先驗證使用者是否為標籤的管理員。
本範例使用 ID
刪除正確的標籤。
Python
response = service.labels().delete(
name='labels/ID',
useAdminAccess=True).execute()
Node.js
service.labels.delete({
'name': 'labels/ID',
'use_admin_access': true
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
標籤具有 DELETED
的 State
,且標籤的修訂版本 ID 會增加。無法套用標籤,且刪除的標籤最終會遭到清除。詳情請參閱「標籤生命週期」。