Microsoft Graph日历Delta查询误将修改事件标记为删除的问题

问题背景 #

使用C# Microsoft Graph NuGet包4.36集成规划器应用与Outlook.com日历，执行Delta查询时出现偶发异常：

• 将事件修改至今日及之后时间时，Delta查询会把该事件标记为已删除（AdditionalData中包含@removed: {"reason":"deleted"}），且事件的Start、End属性为null；
• 若事件移至今日之前，Delta查询表现正常；
• 不携带deltaToken执行全量查询时，所有事件均能正常返回，无此误报。

根本原因 #

这是Microsoft Graph API针对CalendarView Delta查询的特定行为：
CalendarView Delta查询是基于初始请求中指定的startdatetime和enddatetime时间范围跟踪变更的。当事件的时间被修改至超出当前Delta查询的enddatetime范围时，API会将该事件标记为「从当前视图中移除」（返回@removed标记），而非返回更新后的事件。

你的代码中enddatetime设置为DateTime.Now.ToString("o")（当前时间），当把事件移至今日及之后时，事件的时间范围超出了初始Delta查询的结束时间，因此被误判为「删除」。

官方解决方案 #

1. 扩大enddatetime的时间范围 #

将enddatetime设置为足够远的未来时间，确保修改后的事件仍在查询范围内，避免因时间变更被移出视图。修改代码中的enddatetime参数：

queryOptions.Add(new QueryOption("enddatetime", 
    DateTime.Now.AddYears(1).ToString("o"))); // 设置为1年后的时间

2. 切换到Events的Delta查询（而非CalendarView） #

如果业务场景不需要按时间范围过滤事件，直接对所有日历事件执行Delta查询，而非基于CalendarView的时间范围跟踪。这样事件的时间变更不会触发误删标记：

// 替换原CalendarView.Delta()为Events.Delta()
return await AppClient.Users[userId].Calendar.Events
    .Delta()
    .Request(queryOptions)
    .Header("Prefer", "outlook.body-content-type='text'")
    .Header("Prefer", "outlook.timezone=\"W. Europe Standard Time\"")
    .Header("Prefer", $"odata.maxpagesize={maxPageCount}")
    .GetAsync();

3. 优化@removed标记的处理逻辑 #

当收到带有@removed标记的事件时，不要直接判定为删除，而是通过事件ID调用API验证事件是否真实存在：

// 对标记为删除的事件进行二次验证
if (happening.AdditionalData.ContainsKey("@removed"))
{
    try
    {
        var actualEvent = await AppClient.Users[userId].Calendar.Events[happening.Id]
            .Request()
            .Header("Prefer", "outlook.body-content-type='text'")
            .Header("Prefer", "outlook.timezone=\"W. Europe Standard Time\"")
            .GetAsync();
        // 事件存在，说明是误报，视为更新
        calendarList.Add(actualEvent);
    }
    catch (ServiceException ex) when (ex.StatusCode == System.Net.HttpStatusCode.NotFound)
    {
        // 事件确实不存在，执行删除逻辑
    }
}

额外优化建议 #

• 不要手动截取deltaToken，直接保存完整的@odata.deltaLink。DeltaLink包含了初始查询的所有参数（如时间范围），手动截取可能导致参数丢失，引发异常：

  // 直接保存完整的deltaLink
  var deltaLink = newEvents.AdditionalData["@odata.deltaLink"].ToString();
  // 下次请求时直接使用该链接创建请求
  var deltaRequest = new EventDeltaRequest(new Uri(deltaLink), AppClient, null);
  var updatedEvents = await deltaRequest.GetAsync();
  

• 避免使用动态的enddatetime（如DateTime.Now），固定或设置足够大的时间范围，防止事件因时间变更被移出查询视图。

内容的提问来源于stack exchange，提问作者Håkon Seljåsen