您可以通过应用一组更新请求来更新单个标签，从而生成新的草稿修订版本。例如，您可以更新现有标签的属性（标签说明），也可以为标签添加新的 Field。
由于该方法接受更新 Request 对象的列表，因此标签更新会作为批量更新进行。它会按照批量请求中指定的顺序进行更新。批量更新中的更新会以原子方式应用。也就是说，如果批处理中的任何请求都未成功，则整个更新都将失败，并且系统不会应用任何（可能依赖的）更改。标签保持不变。
如果更新成功，您必须先发布生成的草稿修订版，然后才能对任何云端硬盘内容使用这些更改。
更新标签对象
标签包含许多其他可更新的对象类型，例如：
- 标签属性
- 字段和字段类型
- 选择选项和选择选项属性
这些是控制标签的外观和操作的众多对象中的一部分。
操作类别
labels.delta 方法支持的以下操作可分为以下几大类：
| 类别 | 说明 |
|---|---|
| 创建 | 添加对象。 |
| 更新 | 更新对象的某些属性。 |
| 启用 | 启用对象。 |
| 停用 | 停用对象。 |
| 删除 | 移除对象。 |
下一部分将使用这些类别来描述特定操作的行为。
更新请求
labels.delta 方法的工作原理是接受一个或多个 Request 对象，每个对象指定要执行的单一类型的请求。请求有很多种不同的类型。下面按不同类别对请求类型进行了细分。
字段掩码
许多“更新”和“停用”类型的请求都需要 FieldMask。这是您要更新的字段的逗号分隔列表，其他字段保持不变。必须使用该掩码，以确保仅更新您要修改的字段。您必须至少指定一个字段。
示例
如需更新标签，请对 labels 集合使用 delta 方法。
您还必须指定：
useAdminAccess是true，用于使用用户的管理员凭据。服务器会先验证用户是否为标签的管理员，然后再允许访问。用于指定标签的适用更新的
Request。通过
property方法创建的标签title。一个或多个
Field。表示每个标签的标签资源。它包含资源
Name和ID，后者是标签的全局唯一标识符。LabelView是LABEL_VIEW_FULL，用于设置应用于标签响应的资源视图。LABEL_VIEW_FULL会返回所有可能的字段。
此示例使用 ID 更新正确的标签。
Python
body = {
'use_admin_access': True,
'requests': [{
'update_label': {
'properties': {
'title': 'TITLE'
},
'update_mask': {
'paths': ['title']
}
},
}, {
'create_field': {
'field': {
'properties': {
'display_name': 'DISPLAY_NAME'
},
'text_options': {}
}
}
}],
'view': 'LABEL_VIEW_FULL'
}
response = service.labels().delta(
body=body,
name='labels/ID').execute()
Node.js
var body = {
'use_admin_access': true,
'requests': [{
'update_label': {
'properties': {
'title': 'TITLE'
},
'update_mask': {
'paths': ['title']
}
},
}, {
'create_field': {
'field': {
'properties': {
'display_name': 'DISPLAY_NAME'
},
'text_options': {}
}
}
}],
'view': 'LABEL_VIEW_FULL'
};
service.labels.delta({
'resource': body,
'name': 'labels/ID'
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
系统会更新标签、字段或选项，标签的修订 ID 会递增，并且标签会作为草稿标签存储在数据库中。标签的 State 为 PUBLISHED，hasUnpublishedChanges=true 表示有草稿更改，但用户无法看到。更新后的标签必须为 PUBLISHED，用户才能看到更改。如需了解详情，请参阅标签生命周期。