停用已發布的標籤。停用標籤之後,系統會根據目前已發布的修訂版本,產生新的已停用且已發布修訂版本。如果有修訂版本草稿,系統會根據最新修訂版本草稿,建立新的草稿修訂版本。系統會刪除較舊的修訂版本草稿。
停用後,即可使用 labels.delete
刪除標籤。
HTTP 要求
POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
必要欄位。標籤資源名稱。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "updateMask": string, "useAdminAccess": boolean, "writeControl": { object ( |
欄位 | |
---|---|
updateMask |
要更新的欄位。至少須指定一個欄位。根層級 |
useAdminAccess |
如要使用使用者的管理員憑證,請設為 |
writeControl |
可讓您控管寫入要求的執行方式。預設為未設定,表示採用最後寫入者。 |
disabledPolicy |
已停用要使用的政策。 |
languageCode |
用於評估本地化欄位標籤的 BCP-47 語言代碼。如未指定,系統會使用預設語言的值。 |
回應主體
如果成功,回應主體會包含 Label
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
詳情請參閱授權指南。