GraphAPI中将Outlook收件箱邮件移至垃圾邮件文件夹报错求助

问题根源 #

你的代码存在两个关键错误：

1. 资源定位错误：调用mailFolders(message.id)时，传入的message.id是邮件ID，但mailFolders()方法需要的是文件夹ID，这导致Graph API无法识别该ID，抛出ErrorInvalidIdMalformed错误。
2. 目标参数错误：withDestinationId("Junk E-mail")直接使用文件夹显示名称，而Graph API的move方法要求传入目标文件夹的ID（不同语言环境下文件夹名称可能不同，比如中文环境是"垃圾邮件"）。

修正后的代码 #

步骤1：获取垃圾邮件文件夹ID #

Graph API提供了well-known的文件夹别名，垃圾邮件文件夹的别名是junk，可直接用该别名获取文件夹对象：

// 获取垃圾邮件文件夹（建议缓存该ID，避免重复请求）
MailFolder junkFolder = _appClient.users(o365Mailbox)
        .mailFolders("junk")
        .buildRequest()
        .get();

步骤2：移动指定邮件到垃圾邮件文件夹 #

定位到目标邮件，调用邮件的move方法并传入垃圾邮件文件夹ID：

private static void moveMailsToJunk(String o365Mailbox, Message message) {
    System.out.println(message.id);
    
    // 获取垃圾邮件文件夹
    MailFolder junkFolder = _appClient.users(o365Mailbox)
            .mailFolders("junk")
            .buildRequest()
            .get();
    
    // 执行邮件移动操作
    _appClient.users(o365Mailbox)
            .messages(message.id) // 定位到要移动的邮件
            .move(MailFolderMoveParameterSet
                    .newBuilder()
                    .withDestinationId(junkFolder.id) // 使用垃圾邮件文件夹ID
                    .build())
            .buildRequest()
            .post();
}

额外优化建议 #

• 缓存文件夹ID：如果需要批量移动邮件，提前获取一次junkFolder.id并缓存，避免每次移动都请求文件夹信息，提升执行效率。
• 添加异常处理：可通过try-catch块捕获GraphServiceException，处理权限不足、邮件不存在等API调用异常。

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