本文說明如何執行下列標籤相關工作:
- 停用標籤
- 啟用標籤
- 刪除標籤
停用標籤
停用標籤會根據目前發布的修訂版本,產生新的已停用發布修訂版本。如有草稿修訂版本,系統會根據最新的草稿修訂版本,建立新的已停用草稿修訂版本。系統會刪除較舊的草稿修訂版本。詳情請參閱「標籤生命週期」。
停用後,使用者仍可透過 Google 雲端硬碟標籤 API 套用這個標籤。標籤仍會顯示在已套用的項目和搜尋結果中。停用的標籤可以刪除。
如要停用已發布的標籤,請對 labels 資源使用 disable 方法。
此外,您還必須指定:
useAdminAccess查詢參數設為true,即可使用使用者的管理員憑證。伺服器會先驗證使用者是否具備必要的管理分類標籤管理員權限,再允許存取。
以下程式碼範例說明如何使用標籤的 id 停用正確的標籤:
Python
service.labels().disable(
name='labels/ID',
body={
'useAdminAccess': True
}
).execute()
Node.js
service.labels.disable({
name: 'labels/ID',
requestBody: {
useAdminAccess: true
}
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
將 ID 替換為要停用的標籤 ID。
標籤具有 State 的 DISABLED,且標籤的修訂版本 ID 會遞增。使用者可以透過雲端硬碟標籤 API 套用標籤。不過,除非設定 DisabledPolicy 物件的 showInApply 欄位,否則 UI 不會顯示已停用的標籤。
啟用標籤
啟用已停用的標籤後,標籤就會恢復為已發布狀態。系統會根據目前停用的已發布修訂版本,產生新的已發布修訂版本。如果現有草稿修訂版本已停用,系統會根據該草稿建立並啟用新修訂版本。詳情請參閱「標籤生命週期」。
如要啟用已停用的標籤,請對 labels 資源使用 enable 方法。
此外,您還必須指定:
useAdminAccess查詢參數設為true,即可使用使用者的管理員憑證。伺服器會先驗證使用者是否具備必要的管理分類標籤管理員權限,再允許存取。
以下程式碼範例說明如何使用標籤的 id 啟用正確標籤:
Python
service.labels().enable(
name='labels/ID',
body={
'useAdminAccess': True
}
).execute()
Node.js
service.labels.enable({
name: 'labels/ID',
requestBody: {
useAdminAccess: true
}
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
將 ID 替換為要啟用的標籤 ID。
標籤具有 State 的 PUBLISHED,且標籤的修訂版本 ID 會遞增。使用者可以透過 Drive Labels API 查看及為檔案套用標籤。
刪除標籤
只能刪除草稿和已停用的標籤。刪除標籤後,系統會從雲端硬碟檔案中永久移除先前已套用該標籤的所有例項,包括使用者輸入的任何相應欄位值。
如要刪除標籤,請先停用標籤,然後在 labels 資源上使用 delete 方法。
此外,您還必須指定:
useAdminAccess查詢參數設為true,即可使用使用者的管理員憑證。伺服器會先驗證使用者是否具備必要的管理分類標籤管理員權限,再允許存取。
以下程式碼範例說明如何使用標籤的 id 刪除正確標籤:
Python
response = service.labels().delete(
name='labels/ID',
useAdminAccess=True
).execute()
Node.js
service.labels.delete({
name: 'labels/ID',
useAdminAccess: true
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
將 ID 替換為要刪除的標籤 ID。
標籤具有 State 的 DELETED,且標籤的修訂版本 ID 會遞增。標籤無法套用,且刪除的標籤最終會遭到清除。詳情請參閱「標籤生命週期」。