Microsoft Graph API：如何通过transactionId删除日历事件（无需保存事件ID）

能不能直接用transactionId删除？ #

不行，Microsoft Graph API的日历事件删除接口必须指定事件ID，没有直接通过transactionId删除的端点，所以必须先查询到对应事件的ID，再执行删除操作。

通过transactionId查询后删除的具体步骤 #

1. 查询目标事件：发送GET请求，用$filter过滤出transactionId匹配目标FlowID的事件。示例请求：

   GET /me/events?$filter=transactionId eq '你的FlowID值'
   

   注：如果你的系统可能存在多个同transactionId的事件，可以额外添加过滤条件（比如createdDateTime ge 2024-01-01T00:00:00Z）缩小范围，避免误删。
2. 获取事件ID：处理返回的JSON结果，取第一个匹配事件的id字段（确保你的业务逻辑里一个FlowID只会对应一个日历事件）。
3. 执行删除：用拿到的事件ID调用删除接口：

   DELETE /me/events/{event-id}
   

其他可自定义的字段方案 #

如果transactionId满足不了需求，还可以用以下自定义字段实现：

• 单值扩展属性（singleValueExtendedProperties）：这是最推荐的方案，属于隐藏的自定义属性，不会影响日历事件的显示。
  • 创建事件时，在请求体中添加扩展属性：

    {
      "subject": "会议标题",
      "start": { "dateTime": "2024-05-20T10:00:00", "timeZone": "UTC" },
      "end": { "dateTime": "2024-05-20T11:00:00", "timeZone": "UTC" },
      "singleValueExtendedProperties": [
        {
          "id": "String {00000000-0000-0000-0000-000000000000} Name FlowID",
          "value": "你的FlowID值"
        }
      ]
    }
    

    （注：{00000000-0000-0000-0000-000000000000}可以替换成你自己生成的GUID）
  • 查询时用扩展属性过滤：

    GET /me/events?$filter=singleValueExtendedProperties/any(ep: ep/id eq 'String {你的GUID} Name FlowID' and ep/value eq '你的FlowID值')
    

• 主题（subject）或正文（body）：如果不介意FlowID暴露在可见区域，可以在主题里加标识（比如"[FlowID:XXX] 项目同步会"），然后用$filter=subject contains '[FlowID:XXX]'查询，但这种方式容易出现匹配冲突，仅适合简单场景。

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