<think>
我们使用
Microsoft Graph API来实现
下载Outlook邮箱中的
邮件附件。根据引用[1]和引用[3]，我们知道可以使用
Microsoft Graph API来操作邮件，
并且可以使用Java SDK。引用[2]展示了如何通过
Graph API获取事件（
events），类似地，我们可以获取邮件的
附件。
步骤概述：
1. 注册应用
并获取认证：在Azure AD中注册应用，
并授予相应的
API权限（如Mail.Read）。
2. 配置身份认证：使用OAuth 2.0获取访问令牌（Access
Token）。
3. 使用
Microsoft Graph Java SDK：通过
GraphServiceClient对象访问邮箱数据。
4. 获取邮件及其
附件：首先获取邮件列表，然后根据邮件ID获取
附件列表，最后
下载附件。
具体步骤：
### 1. 注册应用
并配置权限
- 在Azure Portal中注册一个应用程序。
-
添加API权限：选择
Microsoft Graph，然后选择应用权限（如果是后台服务）或委派权限（如果是用户登录）。对于
下载附件，需要`Mail.Read`权限（委派权限）或`Mail.Read`（应用权限，如果是服务账户）。
- 获取客户端ID（client_id）和租户ID（tenant_id），如果是服务账户，则还需要客户端密码（client_secret）。
### 2.
添加依赖
在项目中
添加Microsoft Graph SDK和Azure Identity客户端的依赖（如引用[3]所示）：
```xml
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.14.0</version>
</dependency>
<dependency>
<groupId>com.
microsoft.
graph</groupId>
<artifactId>
microsoft-
graph</artifactId>
<version>6.19.0</version>
</dependency>
```
### 3. 获取访问令牌
使用Azure Identity库来获取访问令牌。有两种主要方式：
- 交互式登录（适用于委派权限）
- 客户端凭据（适用于应用权限）
这里以客户端凭据（服务账户）为例：
```java
import com.azure.identity.ClientSecretCredential;
import com.azure.identity.ClientSecretCredentialBuilder;
ClientSecretCredential credential = new ClientSecretCredentialBuilder()
.clientId("<your-client-id>")
.clientSecret("<your-client-secret>")
.tenantId("<your-tenant-id>")
.build();
```
### 4. 创建
GraphServiceClient
使用上面获取的凭据创建
GraphServiceClient：
```java
import com.
microsoft.
graph.authentication.
TokenCredentialAuthProvider;
import com.
microsoft.
graph.requests.
GraphServiceClient;
final List<String> scopes = Arrays.asList("https://
graph.
microsoft.com/.default");
TokenCredentialAuthProvider authProvider = new
TokenCredentialAuthProvider(scopes, credential);
GraphServiceClient<Request>
graphClient =
GraphServiceClient
.builder()
.authenticationProvider(authProvider)
.buildClient();
```
### 5. 获取
邮件附件
假设我们要
下载某个特定邮件（已知邮件ID）的
附件，或者先获取所有邮件，然后针对每封邮件
下载附件。
#### 步骤：
- 获取用户邮件列表（或根据邮件ID获取单封邮件）
- 获取该邮件的
附件列表
- 遍历
附件列表，
下载每个
附件
#### 示例代码：
```java
// 获取用户邮件列表（这里获取前10封邮件）
UserRequestBuilder user =
graphClient.users("<user-id>"); // 或者使用
graphClient.me()来获取当前用户
MessageCollectionPage messages = user.messages()
.buildRequest()
.
top(10)
.get();
for (Message message : messages.getCurrentPage()) {
String messageId = message.id;
// 获取该邮件的
附件
AttachmentCollectionPage
attachments = user.messages(messageId).
attachments()
.buildRequest()
.get();
for (
Attachment attachment :
attachments.getCurrentPage()) {
if (
attachment instanceof File
Attachment) {
File
Attachment file
Attachment = (File
Attachment)
attachment;
//
下载附件内容（字节数组）
byte[] content = file
Attachment.contentBytes;
// 保存到本地
String fileName = file
Attachment.name;
Path filePath = Paths.get("/path/
to/save/" + fileName);
Files.write(filePath, content);
System.out.println("Saved
attachment: " + fileName);
}
}
}
```
注意：
- 如果使用应用权限，需要确保管理员已经授予了应用程序的权限（在Azure Portal中完成）。
- 如果使用委派权限，则需要用户登录，
并且访问令牌将代表该用户。
### 6. 处理分页
上面的示例只处理了第一页的邮件和
附件。如果需要处理更多的邮件，需要处理分页。
Microsoft Graph SDK提供了分页支持。
例如，处理邮件分页：
```java
MessageCollectionPage messages = user.messages()
.buildRequest()
.
top(10)
.get();
while (messages != null) {
List<Message> currentPage = messages.getCurrentPage();
// 处理当前页的邮件...
// 获取下一页
if (messages.getNextPage() != null) {
messages = messages.getNextPage().buildRequest().get();
} else {
messages = null;
}
}
```
附件分页同理。
### 7. 错误处理
在实际应用中，需要
添加异常处理，例如处理网络错误、权限不足等。
### 注意事项
- 权限：确保应用具有足够的权限（例如，对于
读取邮件附件，需要`Mail.Read`权限）。
- 用户标识：如果使用`
graphClient.users("<user-id>")`，需要知道用户的id或者用户主体名称（UPN），使用`
graphClient.me()`可以访问当前登录用户的邮箱（委派权限场景下）。
- 文件保存路径：确保程序有权限写入指定的保存路径。
以上步骤展示了如何使用
Microsoft Graph API在Java中
下载Outlook邮箱中的
邮件附件。通过
Graph SDK，我们可以方便地访问邮件和
附件数据，
并将
附件内容保存到本地。
§§相关问题§§
1. 如何在Azure Portal中为应用程序
添加Microsoft Graph的
API权限？
2. 如何通过
Microsoft Graph API获取特定邮件的详细信息（如主题、发件人等）？
3. 如何处理
Microsoft Graph API的分页查询？
4.
Microsoft Graph API中的委派权限和应用权限有什么区别，如何选择？
</think>
### 使用
Microsoft Graph API 在 Java 中
下载 Outlook 邮件附件
以下是基于
Microsoft Graph API 实现
Outlook 邮件附件下载的完整方案，结合您提供的引用内容实现 OAuth 2.0 认证和
API 调用。
---
#### **1. 准备工作：配置 Azure AD 应用**
1. 在 Azure Portal 注册应用
-
添加 `Mail.Read` 权限（委派权限）
- 获取 **客户端 ID** 和 **租户 ID**
2. 生成客户端密码
- 在 "证书和密码" 中创建新客户端密码
- 保存 **客户端密钥**（clientSecret）
---
#### **2.
添加依赖**
在 `pom.xml` 中
添加引用[^3]提到的依赖：
```xml
<dependencies>
<!-- Azure 身份认证 -->
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.14.0</version>
</dependency>
<!--
Microsoft Graph SDK -->
<dependency>
<groupId>com.
microsoft.
graph</groupId>
<artifactId>
microsoft-
graph</artifactId>
<version>6.19.0</version>
</dependency>
<!-- JSON 处理 -->
<dependency>
<groupId>org.json</groupId>
<artifactId>json</artifactId>
<version>20210307</version>
</dependency>
</dependencies>
```
---
#### **3. OAuth 2.0 认证实现**
参考引用[^1]和[^3]，使用客户端凭证流获取访问令牌：
```java
import com.azure.identity.ClientSecretCredential;
import com.azure.identity.ClientSecretCredentialBuilder;
public class AuthProvider {
public static ClientSecretCredential getCredential() {
return new ClientSecretCredentialBuilder()
.clientId("<YOUR_CLIENT_ID>") // Azure 应用 ID
.clientSecret("<YOUR_CLIENT_SECRET>")
.tenantId("<YOUR_TENANT_ID>") // Azure 租户 ID
.build();
}
}
```
---
#### **4.
下载邮件附件核心代码**
参考引用[^2]的请求模式，实现
附件下载：
```java
import com.
microsoft.
graph.models.
Attachment;
import com.
microsoft.
graph.models.File
Attachment;
import com.
microsoft.
graph.models.Message;
import com.
microsoft.
graph.requests.
AttachmentCollectionPage;
import com.
microsoft.
graph.requests.
GraphServiceClient;
import okhttp3.Request;
import java.io.FileOutputStream;
import java.nio.file.Path;
import java.nio.file.Paths;
public class
AttachmentDownloader {
public static void download
Attachments(String userId, String messageId) {
// 创建
Graph 客户端
GraphServiceClient<Request>
graphClient =
GraphServiceClient.builder()
.authenticationProvider(AuthProvider::getCredential)
.buildClient();
// 获取
邮件附件列表
AttachmentCollectionPage
attachments =
graphClient.users(userId)
.messages(messageId)
.
attachments()
.buildRequest()
.get();
// 遍历
并下载附件
for (
Attachment attachment :
attachments.getCurrentPage()) {
if (
attachment instanceof File
Attachment) {
File
Attachment file
Attachment = (File
Attachment)
attachment;
byte[] content = file
Attachment.contentBytes;
// 保存到本地文件
Path filePath = Paths.get("/downloads/" + file
Attachment.name);
try (FileOutputStream stream = new FileOutputStream(filePath.
toFile())) {
stream.write(content);
System.out.println("
下载成功: " + file
Attachment.name);
} catch (Exception e) {
System.err.println("
下载失败: " + e.getMessage());
}
}
}
}
public static void main(String[] args) {
download
Attachments(
"user@con
toso.com", // 用户邮箱
"AAMkAGI1...AAA=" // 邮件ID（通过收件箱查询获取）
);
}
}
```
---
#### **5. 关键参数获取**
1. **获取邮件 ID**
使用收件箱查询（参考引用[^2]）：
```java
MessageCollectionPage messages =
graphClient.users("user@con
toso.com")
.messages()
.buildRequest()
.get();
messages.getCurrentPage().forEach(message -> {
System.out.println("ID: " + message.id + " | 主题: " + message.subject);
});
```
2. **权限说明**
- 需要 Azure AD 授予 `Mail.Read` 权限
- 如果是服务账号，需
添加应用权限而非委派权限
---
#### **6. 最佳实践建议**
1. **分页处理**
当
附件数量超过单页限制时，实现分页遍历：
```java
AttachmentCollectionRequestBuilder request =
graphClient.users(userId)
.messages(messageId)
.
attachments();
while (request != null) {
AttachmentCollectionPage page = request.buildRequest().get();
// 处理当前页
附件
request = page.getNextPage() != null
?
page.getNextPage().buildRequest() : null;
}
```
2. **错误处理**
添加身份验证失败重试机制：
```java
try {
//
API 调用
} catch (
GraphServiceException ex) {
if (ex.getStatusCode() == 401) { // 未授权
// 刷新令牌后重试
}
}
```
3. **大
附件处理**
对于超过 4MB 的
附件，使用分段
下载：
```java
AttachmentItem
attachmentItem = new
AttachmentItem();
attachmentItem.
attachmentType =
AttachmentType.FILE;
attachmentItem.name = "largefile.zip";
attachmentItem.size = 1024 * 1024 * 10; // 10MB
UploadSession uploadSession =
graphClient.users(userId)
.messages(messageId)
.
attachments()
.createUploadSession(
attachmentItem)
.buildRequest()
.post();
```
---
本文介绍了MicrosoftGraph的概念及其在Microsoft365和AzureARM中的作用，包括O365Graph和AzureResourceGraph两种类型，并提供了通过O365GraphAPI给Outlook事件添加附件的具体实例。
正在上传…
最低0.47元/天 解锁文章
扫一扫
2037
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
