使用Graph API delta查询获取AAD组成员时如何提取用户列表

你当前的代码存在两个核心问题，导致无法拿到完整的组内用户列表：

1. 接口调用错误：graphClient.Groups.Delta()是查询租户下所有AAD组对象的增量接口，即使加了id eq '{groupId}'的过滤，返回的也只是对应组本身的对象，不是组下的成员。
2. 未处理分页逻辑：Delta接口默认分页返回，单页仅返回最多Top()参数指定条数的结果，你只取了第一页数据，没有遍历后续分页，自然拿不到全量结果。

1. 替换为组成员增量查询接口 #

要获取指定组下的成员增量，需要调用组的members导航属性对应的delta接口，修正后的第一页请求代码如下：

// 注意返回类型是IGroupMembersDeltaCollectionPage，不是组集合的页类型
public async Task<IGroupMembersDeltaCollectionPage> GetGroupMembersFirstDeltaPageAsync(string groupId)
{
    return await graphClient.Groups[groupId].Members.Delta()
        .Request()
        .Top(MaxResultCount)
        .GetAsync();
}

2. 遍历分页拉取全量成员 #

返回的分页对象中，CurrentPage属性存储当前页的目录对象，你需要循环判断@odata.nextLink是否存在，持续请求下一页直到拿到@odata.deltaLink，才代表拉取完所有数据。完整代码如下：

public async Task<List<User>> GetFullGroupUserListAsync(string groupId)
{
    var allDirectoryObjects = new List<DirectoryObject>();
    // 拉取第一页
    var currentPage = await GetGroupMembersFirstDeltaPageAsync(groupId);
    allDirectoryObjects.AddRange(currentPage.CurrentPage);

    // 循环拉取后续分页
    while (currentPage.AdditionalData.TryGetValue("@odata.nextLink", out var nextLinkObj) && nextLinkObj != null)
    {
        var nextPageRequest = new GroupMembersDeltaRequest(nextLinkObj.ToString(), graphClient, null);
        currentPage = await nextPageRequest.GetAsync();
        allDirectoryObjects.AddRange(currentPage.CurrentPage);
    }

    // 拉取完成后可从AdditionalData中取出deltaLink持久化存储，后续增量同步直接使用该链接即可，无需从头拉取
    if (currentPage.AdditionalData.TryGetValue("@odata.deltaLink", out var deltaLinkObj))
    {
        var savedDeltaLink = deltaLinkObj.ToString();
        // 自行实现deltaLink的持久化逻辑，比如存到数据库
    }

    // 成员集合中可能包含组、设备、服务主体等非用户对象，需要筛选出User类型
    return allDirectoryObjects.OfType<User>().ToList();
}

如果你确实是要调用/groups/delta查询组对象列表而非组内成员，分页遍历逻辑和上述一致，只需要将页类型替换为IGroupDeltaCollectionPage，对应下一页请求用GroupDeltaRequest构造即可，组对象同样从CurrentPage属性获取。

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