如何通过iCalUId调用Microsoft Graph API获取周期性日历事件实例详情？

嘿，我明白你遇到的困扰了——用iCalUId过滤/me/events能正常拿到单个事件，但对周期性事件的实例就返回空，这其实是API的预期行为，不是你的操作有误！

为什么原来的方法行不通？ #

周期性事件的主事件（父事件）和所有重复实例共享同一个iCalUId，而/me/events端点默认只返回主事件，不会把单个实例包含在这个集合里。所以你用iCalUId过滤时，只会拿到主事件，而找不到目标实例。

两种可行的解决方法 #

方法1：先获取主事件，再拉取实例列表

你可以先通过iCalUId找到主事件，再调用主事件的instances端点获取所有实例，最后筛选出你需要的那个：

1. 调用接口获取主事件：

   GET https://graph.microsoft.com/v1.0/me/events?$filter=iCalUId eq 'your-icaluid-value'
   

2. 从响应中提取主事件的id，然后调用实例接口（可添加$select指定需要的字段，或用$filter按时间筛选）：

   GET https://graph.microsoft.com/v1.0/me/events/{master-event-id}/instances?$select=id,subject,start,end&$filter=start/dateTime eq '2024-05-20T10:00:00Z'
   

   这样就能拿到对应时间的实例详情了。

方法2：使用calendarView端点直接筛选实例

calendarView端点会返回指定时间范围内的所有事件（包括周期性实例），你可以结合iCalUId和时间范围来定位目标实例：

GET https://graph.microsoft.com/v1.0/me/calendarView?startDateTime=2024-05-20T00:00:00Z&endDateTime=2024-05-21T00:00:00Z&$filter=iCalUId eq 'your-icaluid-value'

注意这里的startDateTime和endDateTime需要覆盖目标实例的时间区间，这样就能直接返回该实例了。

补充说明 #

如果目标实例是被修改过的“例外实例”（比如调整过时间或内容），它依然会和主事件共享iCalUId，但在instances或calendarView的响应中会有isException: true的标记，方便你识别。

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