使用Graph API统计带/不带保留标签的邮件数量的技术咨询

1. 实现统计需求的正确方式 #

你不需要检查MultiValueExtendedProperties、SingleValueExtendedProperties或Extensions属性，邮件的保留标签信息直接存储在**retentionLabel**属性中，这是Graph API为邮件对象提供的原生属性。

关键步骤： #

• 确保应用已申请Mail.Read应用权限（无人值守场景），并在Azure AD中完成权限授予。
• 使用Graph SDK时，必须显式指定选择retentionLabel属性（默认请求不会返回该字段）。
• 通过判断retentionLabel是否为null，区分带/不带保留标签的邮件。

代码示例： #

// 统计单个用户的邮件标签情况
var userEmail = "user@contoso.com";

// 方式1：拉取邮件属性后统计
var messagesResponse = await graphClient.Users[userEmail].MailFolders["AllItems"].Messages
    .GetAsync(requestConfiguration =>
    {
        requestConfiguration.QueryParameters.Select = new[] { "retentionLabel" };
        requestConfiguration.QueryParameters.Count = true;
        requestConfiguration.Headers.Add("ConsistencyLevel", "eventual");
    });

int labeledCount = messagesResponse.Value.Count(m => m.RetentionLabel != null);
int unlabeledCount = messagesResponse.Value.Count(m => m.RetentionLabel == null);

// 方式2：直接通过Filter+Count获取统计数（无需拉取全量邮件）
var labeledCountResp = await graphClient.Users[userEmail].MailFolders["AllItems"].Messages
    .GetAsync(requestConfiguration =>
    {
        requestConfiguration.QueryParameters.Filter = "retentionLabel ne null";
        requestConfiguration.QueryParameters.Count = true;
        requestConfiguration.Headers.Add("ConsistencyLevel", "eventual");
    });
int labeledCountDirect = labeledCountResp.OdataCount.Value;

var unlabeledCountResp = await graphClient.Users[userEmail].MailFolders["AllItems"].Messages
    .GetAsync(requestConfiguration =>
    {
        requestConfiguration.QueryParameters.Filter = "retentionLabel eq null";
        requestConfiguration.QueryParameters.Count = true;
        requestConfiguration.Headers.Add("ConsistencyLevel", "eventual");
    });
int unlabeledCountDirect = unlabeledCountResp.OdataCount.Value;

2. 优化遍历效率，避免全量遍历 #

不需要遍历所有组、组用户、邮箱文件夹及每封邮件，可通过以下方式大幅提升效率：

• 直接获取全租户用户：通过graphClient.Users.GetAsync()获取所有租户用户（需User.Read.All应用权限），无需先遍历组再提取用户。
• 统一访问"所有邮件"文件夹：直接使用WellKnownFolderName.AllItems文件夹，无需遍历用户的每个邮件子文件夹。
• 利用Graph计数能力：通过$count结合$filter直接返回统计结果，无需拉取所有邮件对象，减少数据传输和处理成本。
• 并行批量处理：对多个用户的统计请求使用Task.WhenAll并行执行，缩短整体耗时。
• 增量统计：若需定期执行任务，可记录上次统计的时间戳，通过$filter=lastModifiedDateTime ge {timestamp}仅统计新增/修改的邮件。

关于Extensions请求错误 #

你无需依赖Extensions属性获取保留标签信息，该错误大概率是SDK版本兼容性或权限配置问题，但对你的需求无影响，直接忽略即可。

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