使用Graph API无法跟踪邮件文件夹变更问题求助

你遇到的核心问题是：Graph API的邮件文件夹delta查询并不支持changeType这个查询参数，所以无论你指定deleted还是created，该参数都会被忽略，导致返回所有类型的变更。

正确的处理方式 #

Graph API的delta查询会返回所有类型的文件夹变更（创建、更新、删除），你需要在获取结果后，通过返回对象的属性来区分变更类型：

• 已删除的文件夹：返回的对象会包含isDeleted: true属性，或者@odata.type为#microsoft.graph.deletedItem
• 重命名（更新）的文件夹：返回的是正常的mailFolder对象，你需要对比本地数据库中该文件夹的旧displayName值，判断是否发生了重命名
• 新建的文件夹：返回的是正常的mailFolder对象，且本地数据库中无对应ID的记录

修正后的代码示例 #

static async Task Main(string[] args)
{
    var tenantId = "some tenantId";
    var clientId = "some clientid";
    var clientSecret = "some client secret";
    CancellationToken cancellationToken = default;

    var credentials = new ClientSecretCredential(
        tenantId,
        clientId,
        clientSecret,
        new TokenCredentialOptions { AuthorityHost = AzureAuthorityHosts.AzurePublicCloud });

    GraphServiceClient _graphServiceClient = new GraphServiceClient(credentials);
    var users = await _graphServiceClient.Users.Request().GetAsync();
    var userId = users.First().Id; // 示例取第一个用户，实际替换为目标用户ID

    string folderDeltaToken = "previous delta token";
    IDeltaCollectionPage<MailFolder> deltaResult;

    if (!string.IsNullOrEmpty(folderDeltaToken))
    {
        // 使用之前保存的delta token获取增量变更
        deltaResult = await _graphServiceClient.Users[userId]
                            .MailFolders
                            .Delta()
                            .Request()
                            .Header("Prefer", "odata.maxpagesize=500") // 可选：设置分页大小
                            .DeltaToken(folderDeltaToken)
                            .GetAsync(cancellationToken);
    }
    else
    {
        // 首次调用，获取初始文件夹数据和delta link
        deltaResult = await _graphServiceClient.Users[userId]
                            .MailFolders
                            .Delta()
                            .Request()
                            .Header("Prefer", "odata.maxpagesize=500")
                            .GetAsync(cancellationToken);
    }

    // 处理变更结果
    foreach (var folder in deltaResult)
    {
        // 判断是否为已删除的文件夹
        if (folder.IsDeleted.HasValue && folder.IsDeleted.Value)
        {
            // 执行删除逻辑：从本地数据库移除该文件夹
            Console.WriteLine($"已删除文件夹: {folder.Id}");
            continue;
        }

        // 判断是否为新建或更新的文件夹
        var localFolder = GetFolderFromDatabase(folder.Id); // 自定义方法：从本地数据库获取对应文件夹
        if (localFolder == null)
        {
            // 执行创建逻辑：将新文件夹存入数据库
            Console.WriteLine($"新建文件夹: {folder.DisplayName} (ID: {folder.Id})");
        }
        else
        {
            // 对比属性判断是否更新（比如重命名）
            if (localFolder.DisplayName != folder.DisplayName)
            {
                // 执行更新逻辑：更新本地数据库中的文件夹名称
                Console.WriteLine($"重命名文件夹: {localFolder.DisplayName} -> {folder.DisplayName} (ID: {folder.Id})");
            }
            // 可扩展判断其他属性变更，比如权限等
        }
    }

    // 保存新的delta token，用于下次查询
    if (deltaResult.AdditionalData.TryGetValue("@odata.deltaLink", out var deltaLink))
    {
        SaveDeltaTokenToStorage(deltaLink.ToString()); // 自定义方法：保存delta token到存储
    }

    Console.ReadKey();
}

// 示例辅助方法（需根据实际实现）
private static FolderModel GetFolderFromDatabase(string folderId)
{
    // 从本地数据库查询对应ID的文件夹
    return null;
}

private static void SaveDeltaTokenToStorage(string deltaLink)
{
    // 将delta token保存到配置文件/数据库等存储
}

关键注意事项 #

1. 不要在delta查询中添加changeType参数，该参数仅部分Graph资源支持（比如驱动器项），但邮件文件夹delta查询不支持
2. 处理删除变更时，确保依赖isDeleted属性，而不是仅判断对象是否存在
3. 每次delta查询完成后，一定要保存返回的@odata.deltaLink，下次查询时使用该链接获取最新增量变更
4. 若需要分页处理大量变更，可通过Prefer头设置分页大小，循环获取所有页面

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