停用已发布的标签。停用标签后,系统将根据当前发布的修订版本更新已停用的已发布修订版本。如果存在草稿修订版本,则系统将根据最新的草稿修订版本创建已停用的新草稿修订版本。较早的草稿修订版本将被删除。
停用标签后,您可以通过 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
有关详情,请参阅授权指南。