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

有关详情,请参阅授权指南