如何在onlineMeetings端点获取recurring meeting的特定实例以更新参与者

核心问题原因 #

重复会议的所有实例共享同一个joinWebUrl和joinMeetingId，直接用这两个字段查询onlineMeetings端点只会返回主会议实例（第一个场次），无法定位到后续场次。而日历事件实例的ID和在线会议实例ID不直接匹配，需要通过事件实例关联对应的在线会议。

具体实现步骤（.NET） #

1. 获取目标时间段内的重复会议日历实例

通过重复会议主事件ID或日历视图，筛选出你需要操作的场次对应的日历事件实例，同时请求关联的在线会议信息：

// 方式一：已知重复会议主事件ID时，获取实例
var eventInstances = await graphClient.Users[userId].Events[recurringMasterEventId].Instances
    .Request()
    .Filter($"start/dateTime ge '2025-05-26T00:00:00Z' and end/dateTime le '2025-05-31T23:59:59Z'")
    .Select("id, start, end, onlineMeeting") // 必须显式请求onlineMeeting属性
    .GetAsync();

// 方式二：未知主事件ID时，通过日历视图筛选
var calendarView = await graphClient.Users[userId].Calendars[calendarId].CalendarView
    .Request()
    .Filter($"start/dateTime ge '2025-05-26T00:00:00Z' and end/dateTime le '2025-05-31T23:59:59Z'")
    .Select("id, start, end, onlineMeeting, subject")
    .GetAsync();

2. 定位目标场次的在线会议实例

从返回的日历实例中，通过会议主题、开始/结束时间匹配到目标场次，取出关联的在线会议ID：

// 从eventInstances或calendarView中筛选目标实例
var targetEventInstance = eventInstances.FirstOrDefault(e => 
    e.Start.DateTime == "2025-05-28T10:00:00Z" && 
    e.End.DateTime == "2025-05-28T11:00:00Z");

if (targetEventInstance?.OnlineMeeting == null)
{
    // 未找到目标实例或关联的在线会议，处理异常
    return;
}

// 获取对应的在线会议实例
var targetOnlineMeeting = await graphClient.Users[userId].OnlineMeetings[targetEventInstance.OnlineMeeting.Id]
    .Request()
    .GetAsync();

3. 更新参与者角色

拿到正确的在线会议实例后，直接调用onlineMeetings端点更新参与者角色：

// 构造新的参与者列表（可按需添加/修改）
var updatedParticipants = new MeetingParticipants
{
    Attendees = new List<MeetingParticipantInfo>
    {
        new MeetingParticipantInfo
        {
            Identity = new IdentitySet
            {
                User = new Identity
                {
                    Id = "目标参会者ID",
                    DisplayName = "参会者名称"
                }
            },
            Role = OnlineMeetingRole.Presenter // 可选：Attendee、Presenter、CoOrganizer等
        }
    }
};

targetOnlineMeeting.Participants = updatedParticipants;

// 提交更新
var updatedMeeting = await graphClient.Users[userId].OnlineMeetings[targetOnlineMeeting.Id]
    .Request()
    .UpdateAsync(targetOnlineMeeting);

关键注意事项 #

• 必须显式在Select中指定onlineMeeting属性，否则Graph API默认不会返回该关联对象。
• 每个重复会议实例对应的在线会议ID是唯一的，与主会议的在线会议ID不同，这是定位到正确场次的核心依据。
• 如果需要批量处理多个场次，可以遍历筛选后的事件实例，逐一关联并更新对应的在线会议。

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