停用、啟用 &刪除標籤

本頁說明如何執行與標籤相關的工作:

  • 停用標籤
  • 啟用標籤
  • 刪除標籤

停用標籤

停用標籤會導致系統根據目前發布的修訂版本停用新的已發布修訂版本。如果有草稿修訂版本,系統會根據最新草稿修訂版本建立已停用的新版草稿修訂版本。系統會刪除較舊的草稿修訂版本。詳情請參閱「標籤生命週期」一文。

停用後,使用者仍然可以透過 API 套用這個標籤。標籤仍會顯示已套用標籤和搜尋結果中的標籤。您可以刪除已停用的標籤。

如要停用已發布的標籤,請針對 labels 集合使用 disable 方法。

您還必須指定:

  • 代表每個標籤的標籤資源。其中包含資源 NameID,這是標籤的全域專屬 ID。

  • useAdminAccesstrue,以便使用使用者的管理員憑證。伺服器會先驗證使用者是標籤管理員,再授予存取權。

本範例使用 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);
});

這個標籤的 StateDISABLED,且標籤的修訂版本 ID 會遞增。使用者也可以透過 API 套用標籤。不過,除非設定 disabledPolicy 方法的 showInApply 屬性,否則已停用標籤。

啟用標籤

啟用停用的標籤後,系統會將該標籤還原為已發布的狀態。而這會產生根據目前已停用的已發布修訂版本所建立的新修訂版本。如果目前已停用的草稿修訂版本,系統會根據該草稿建立新修訂版本並啟用。詳情請參閱「標籤生命週期」一文。

如要啟用已停用的標籤,請使用 enable 方法。

您還必須指定:

  • 代表每個標籤的標籤資源。其中包含資源 NameID,這是標籤的全域專屬 ID。

  • useAdminAccesstrue,以便使用使用者的管理員憑證。伺服器會先驗證使用者是標籤管理員,再授予存取權。

本範例使用 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);
});

這個標籤的 StatePUBLISHED,且標籤的修訂版本 ID 會遞增。使用者可以透過 API 查看及套用標籤。

刪除標籤

只能刪除草稿和已停用的標籤。刪除標籤後,系統會永久刪除先前套用該標籤的所有執行個體,包括使用者輸入的任何對應欄位值,並從這些雲端硬碟檔案中移除。

如要刪除標籤,您必須先停用標籤,然後使用 delete 方法。

您還必須指定:

  • 代表每個標籤的標籤資源。其中包含資源 NameID,這是標籤的全域專屬 ID。

  • useAdminAccesstrue,以便使用使用者的管理員憑證。伺服器會先驗證使用者是標籤管理員,再授予存取權。

本範例使用 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);
});

這個標籤的 StateDELETED,且標籤的修訂版本 ID 會遞增。標籤無法套用,且系統最終會清除已刪除的標籤。詳情請參閱「標籤生命週期」。