Method: labels.disable

停用已發布的標籤。詳情請參閱「停用、啟用及刪除標籤」。

停用標籤後，系統會根據目前發布的版本，產生新的停用發布版本。如果草稿修訂版本存在，系統會根據最新的草稿修訂版本建立新的停用草稿修訂版本。系統會刪除較舊的草稿修訂版本。

停用標籤後，即可使用 labels.delete 刪除標籤。

HTTP 要求

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。標籤資源名稱。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
欄位
updateMask

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根 disabledPolicy 是隱含的，不應指定。單一 * 可做為更新每個欄位的簡寫。
useAdminAccess

boolean

設為 true，即可使用使用者的管理員憑證。伺服器會先驗證使用者是否為唱片公司的管理員，再允許存取。
writeControl

object (WriteControl)

可控管寫入要求的執行方式。預設為未設定，表示以最後寫入者為準。
disabledPolicy

object (DisabledPolicy)

無法使用的政策。
languageCode

string

用於評估本地化欄位標籤的 BCP-47 語言代碼。如未指定，系統會使用預設設定語言的值。

回應主體

如果成功，回應主體會包含 Label 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

詳情請參閱授權指南。