BulkSetEntityPropertyOptions¶
在单次调用中，对多个实体应用一个多选选项增量——通常是一个标签。当用户要求一次性为一组项目打标签或标注时（例如“给最后 50 封电子邮件标记为后续跟进”），请使用此方法，而不是对每个实体分别调用 SetEntityProperty。提供 property_definition_id（来自 ListTags 的标签集的 propertyDefinitionId）以及要添加和/或删除的选项 id（来自 ListTags 的标签的选项 id）。相同的 add_option_ids/remove_option_ids 增量会应用于每个实体；就每个实体而言，该增量会与其并发编辑原子性地组合。
仅适用于多选或标签属性；对于其他值类型或单个实体，请使用 SetEntityProperty。每次调用最多可处理 200 个实体——较大的集合请拆分到多次调用中。
尽力而为：每个实体都会被独立处理。您没有编辑权限的实体会以状态 skipped_no_permission 报告并保持不变，无法接受该属性的实体为 failed，其余实体为 applied——一次调用绝不会因为少数实体不可编辑而整体失败。查看每个实体的结果和摘要以了解具体情况。
参数¶
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
entities |
BulkTargetEntity[] | 是 | 要更新的实体（最多 200 个）。用户无法编辑的实体会被跳过。 |
property_definition_id |
string | 是 | 在每个实体上更改的多选属性定义 id——例如来自 ListTags 的标签集的 propertyDefinitionId。 |
add_option_ids |
string[] | 否 | 要添加到每个实体的选项（例如来自 ListTags 的标签的选项 id），会根据每个实体的当前值进行去重。 |
remove_option_ids |
string[] | 否 | 要从每个实体中删除的选项。删除不存在的选项是空操作。 |
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 macro3/macro