向标签发布所有草稿更改。发布后,标签可能无法恢复为草稿状态。如需了解详情,请参阅 google.apps.drive.labels.v2.Lifecycle
。
发布标签会导致新发布的修订版本。之前的所有草稿修订版本都将被删除。系统会保留之前发布的修订版本,但可能会根据需要自动删除。
发布之后,您将无法再进行某些更改。一般来说,如果更改会导致与标签相关的现有元数据失效或导致新的限制,则更改会被拒绝。例如,发布标签后,以下对标签的更改将会被拒绝:* 不能直接删除标签。必须先将其停用,然后再将其删除。* 无法更改 Field.FieldType。* 对字段验证选项的更改无法拒绝先前接受的内容。* 减少条目数上限。
HTTP 请求
POST https://drivelabels.googleapis.com/v2/{name=labels/*}:publish
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
必需。标签资源名称。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"useAdminAccess": boolean,
"writeControl": {
object ( |
字段 | |
---|---|
useAdminAccess |
设置为 |
writeControl |
控制写入请求的执行方式。默认取消设置,这意味着最后写入内容生效。 |
languageCode |
用于评估本地化字段标签的 BCP-47 语言代码。如果未指定,将使用配置的默认语言的值。 |
响应正文
如果成功,则响应正文包含一个 Label
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
有关详情,请参阅授权指南。