### 使用 Python 通过 Microsoft Graph API 或 Outlook API 登录并读取邮件内容 为了使用 Python 访问微软邮箱的内容，可以采用 Microsoft Graph API 来完成这一操作。这涉及到几个主要步骤：设置应用程序注册、安装必要的库以及编写代码来获取访问令牌和读取消息。 #### 应用程序注册 首先，在 Azure Active Directory (Azure AD) 中为应用注册一个新条目，并授予其所需的权限以访问用户的电子邮件数据。确保启用 `Mail.Read` 和其他任何必需的委托权限[^1]。 #### 安装依赖库 接下来，需安装用于处理身份验证流程和支持 HTTP 请求发送到 Graph API 的 Python 包： ```bash pip install msal requests ``` #### 获取访问令牌 下面是一个简单的例子展示怎样获得 OAuth2.0 流程中的访问令牌以便后续调用 Graph API: ```python import msal authority = 'https://login.microsoftonline.com/common' client_id = '<your-client-id>' scope = ['https://graph.microsoft.com/.default'] secret = '<your-secret>' app = msal.ConfidentialClientApplication( client_id, authority=authority, client_credential=secret) result = app.acquire_token_for_client(scopes=scope) access_token = result['access_token'] if 'access_token' in result else None print(access_token) ``` 这段脚本会打印出有效的访问令牌字符串，该字符串稍后会被用来授权对 Mail API 的请求。 #### 查询邮件项目 一旦有了有效令牌，就可以构建针对 `/me/messages` 终端节点的 GET 请求来检索当前登录用户收件箱里的消息列表了。这里给出一段完整的示例代码片段说明如何执行此过程： ```python import requests def get_emails(access_token): url = f'https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messages?$top=10&$select=subject,receivedDateTime,bodyPreview,sender' headers = { 'Authorization': f'Bearer {access_token}', 'Content-Type': 'application/json', 'Prefer': 'outlook.timezone="Pacific Standard Time"' } response = requests.get(url=url, headers=headers).json() emails = [] try: for message in response['value']: email_data = { "Subject": message["subject"], "Received Date/Time": message["receivedDateTime"], "Body Preview": message["bodyPreview"], "Sender Email Address": message["sender"]["emailAddress"] } emails.append(email_data) return emails except KeyError as e: print(f"Error occurred while fetching emails: {e}") return [] ``` 上述函数定义了一个辅助方法 `get_emails()` ，它接受之前得到的访问令牌作为参数，并返回最近十条收到的消息摘要信息。注意这里的 `$top=10` 参数限制了只拉取最多十封最新的信件；可以根据实际需求调整数量或者去掉这个过滤条件以查看全部历史记录。另外还设置了首选项头文件指定时区偏好，这样能帮助解决不同地区之间的时间差异问题[^3]。