为何为Outlook系列主事件设置扩展属性会同步至所有实例事件？

我之前也碰到过类似的坑——Outlook的系列主事件（series master）和实例事件（occurrences）之间的扩展属性继承机制，确实会导致设置主属性后所有实例都带上相同值。要实现每个事件（不管是主事件还是实例）都有唯一的扩展属性（对应你的应用内ID），得从区分事件类型+单独处理实例入手，具体步骤如下：

1. 先明确事件类型的判断逻辑 #

在通过API获取事件时，一定要检查这几个关键属性，用来区分事件类型：

• IsSeriesMaster: 布尔值，为true时是系列主事件
• IsOccurrence: 布尔值，为true时是常规实例事件
• IsException: 布尔值，为true时是被修改过的例外实例

你可以在GET请求里直接返回这些属性：

GET https://outlook.office.com/api/v2.0/users/{user}/events('{event_id}')?$select=Id,Subject,IsSeriesMaster,IsOccurrence,IsException&$expand=singleValueExtendedProperties($filter=id eq 'String {your_property_id} Name {your_property_name}')

2. 避免在系列主事件上设置需要唯一的扩展属性 #

如果给系列主事件设置了扩展属性，Outlook会自动把这个值继承给所有基于它生成的实例（包括未来新建的实例），这正是你要避免的。所以这个需要对应唯一应用内ID的扩展属性，不要在主事件上设置。

3. 单独给每个实例事件设置唯一扩展属性 #

步骤A：获取系列下的所有实例 #

先通过主事件ID获取该系列的所有实例：

GET https://outlook.office.com/api/v2.0/users/{user}/events('{series_master_id}')/occurrences

这个请求会返回该系列下所有已存在的实例事件列表，每个实例都有自己唯一的Id。

步骤B：逐个给实例更新扩展属性 #

对每个实例，用PATCH请求单独设置唯一的扩展属性值（对应你的应用内ID）：

PATCH https://outlook.office.com/api/v2.0/users/{user}/events('{occurrence_id}')
Content-Type: application/json

{
  "singleValueExtendedProperties": [
    {
      "id": "String {your_custom_property_id} Name {your_property_name}",
      "value": "{unique_app_id_for_this_occurrence}"
    }
  ]
}

这里用PATCH而不是PUT，因为我们只需要更新扩展属性这一部分，不会覆盖事件的其他原有属性。

步骤C：处理例外事件（Exception） #

例外事件是被用户修改过的实例，它们的处理方式和普通实例一样，直接用上面的PATCH请求单独设置唯一属性即可。

4. 处理未来生成的实例 #

如果你需要给未来自动生成的实例也设置唯一属性，建议配置Outlook的webhook通知：

• 订阅EventCreated和EventUpdated事件
• 当新的实例事件被创建时，自动触发你的服务，给该实例设置对应的唯一扩展属性

这样就能确保所有实例（包括未来的）都有独立的扩展属性值了。

内容的提问来源于stack exchange，提问作者Vlad Enache