Method: labels.publish

向标签发布所有草稿更改。发布后，标签可能无法恢复为草稿状态。如需了解详情，请参阅 google.apps.drive.labels.v2.Lifecycle。

发布标签会导致新发布的修订版本。之前的所有草稿修订版本都将被删除。系统会保留之前发布的修订版本，但可能会根据需要自动删除。

发布之后，您将无法再进行某些更改。一般来说，如果更改会导致与标签相关的现有元数据失效或导致新的限制，则更改会被拒绝。例如，发布标签后，以下对标签的更改将会被拒绝：* 不能直接删除标签。必须先将其停用，然后再将其删除。* 无法更改 Field.FieldType。* 对字段验证选项的更改无法拒绝先前接受的内容。* 减少条目数上限。

HTTP 请求

POST https://drivelabels.googleapis.com/v2beta/{name=labels/*}:publish

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。标签资源名称。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
字段
useAdminAccess

boolean

设置为 true 以使用用户的管理员凭据。在允许访问之前，服务器会先验证用户是否为唱片公司的管理员。
writeControl

object (WriteControl)

控制写入请求的执行方式。默认取消设置，这意味着最后写入内容生效。
languageCode

string

用于评估本地化字段标签的 BCP-47 语言代码。如果未指定，将使用配置的默认语言的值。

响应正文

如果成功，则响应正文包含一个 Label 实例。

授权范围

需要以下 OAuth 范围之一：

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

有关详情，请参阅授权指南。