使用 Python 中的 MSGraph SDK 发送电子邮件

使用 Python 中的 MSGraph SDK 发送电子邮件
使用 Python 中的 MSGraph SDK 发送电子邮件
Alice Dupont
2024年4月19日星期五 下午12:14:00

MSGraph Python SDK 入门

集成 Microsoft 的 Graph API 来管理 Python 应用程序中的电子邮件正在成为开发人员的一项关键技能。该技术允许直接通过 Python 自动处理电子邮件，从而增强各种企业应用程序的功能。这里的重点是利用 MSGraph SDK 高效地从用户邮箱重新发送消息。

但是，在实现提供的示例代码时，可能会遇到缺少文件或类的问题，例如缺少 SendMailPostRequestBody 类。本指南旨在解决这些挑战，提出有效发送电子邮件（包括附件）的解决方案，而不依赖于请求等替代库。

命令 描述
GraphClient 初始化客户端以与 Microsoft Graph API 交互，使用提供的 OAuth 令牌进行身份验证。
OAuth2Session 创建用于 OAuth 2 身份验证的会话，从而简化令牌获取和处理。
fetch_token 从 Microsoft 身份平台令牌端点获取 OAuth 令牌。
api() 为特定 Microsoft Graph API 终结点构造请求 URL 以执行发送电子邮件等操作。
post() 使用构建的 API 端点执行 POST 请求，通过 Microsoft Graph API 发送电子邮件等数据。
BackendApplicationClient 用于服务器到服务器通信的客户端，其中不使用用户的凭据，仅使用客户端的凭据。

MSGraph 电子邮件操作的 Python 脚本详细分解

提供的Python脚本旨在通过Microsoft Graph API启用电子邮件操作，特别针对应用程序需要自动执行电子邮件发送任务的场景。使用 MSGraph SDK 中的“GraphClient”可以与 Microsoft 服务直接交互，从而实现发送电子邮件等操作。此客户端设置首先使用 OAuth 令牌建立身份验证流程，并由“OAuth2Session”和“BackendApplicationClient”促进。此设置对于在无需用户交互的情况下安全访问 Microsoft Graph API 至关重要，重点关注服务器到服务器的通信。

成功建立身份验证并使用“fetch_token”方法获取令牌后，脚本将使用“api”和“post”方法构造并发送电子邮件。这些命令直接与 Graph API 的“/me/sendMail”端点交互。电子邮件内容、收件人和其他详细信息以 Graph API 所需的结构化格式指​​定。该脚本举例说明了在业务应用程序中自动化电子邮件流程的实际实现，在与依赖于 Microsoft 生态系统的企业系统集成时特别有用。

使用 MSGraph 和 Python SDK 实现电子邮件自动化

MSGraph 电子邮件操作的 Python 脚本

from msgraph.core import GraphClient
from oauthlib.oauth2 import BackendApplicationClient
from requests_oauthlib import OAuth2Session
client_id = 'YOUR_CLIENT_ID'
client_secret = 'YOUR_CLIENT_SECRET'
tenant_id = 'YOUR_TENANT_ID'
token_url = f'https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token'
client = BackendApplicationClient(client_id=client_id)
oauth = OAuth2Session(client=client)
token = oauth.fetch_token(token_url=token_url, client_id=client_id, client_secret=client_secret)
client = GraphClient(credential=token)
message = {
    "subject": "Meet for lunch?",
    "body": {
        "contentType": "Text",
        "content": "The new cafeteria is open."
    },
    "toRecipients": [{
        "emailAddress": {"address": "frannis@contoso.com"}
    }],
    "ccRecipients": [{
        "emailAddress": {"address": "danas@contoso.com"}
    }]
}
save_to_sent_items = False
response = client.api('/me/sendMail').post({"message": message, "saveToSentItems": str(save_to_sent_items).lower()})
print(response.status_code)

解决 MSGraph SDK 中缺失的类

MSGraph API 的 Python 错误处理

class SendMailPostRequestBody:
    def __init__(self, message, save_to_sent_items):
        self.message = message
        self.save_to_sent_items = save_to_sent_items
try:
    from msgraph.generated.models import Message, Recipient, EmailAddress
except ImportError as e:
    print(f"Failed to import MSGraph models: {str(e)}")
    # Define missing classes manually if not available
    class Message:
        def __init__(self, subject, body, to_recipients, cc_recipients):
            self.subject = subject
            self.body = body
            self.to_recipients = to_recipients
            self.cc_recipients = cc_recipients
    class Recipient:
        def __init__(self, email_address):
            self.email_address = email_address
    class EmailAddress:
        def __init__(self, address):
            self.address = address

在 Python 中扩展 MSGraph 电子邮件功能

当使用 Microsoft Graph API 和 Python 进行电子邮件操作时，了解其更广泛的功能至关重要。除了发送基本电子邮件之外，Graph API 还支持管理电子邮件附件、设置消息重要性和处理已读回执等高级功能。这些功能使开发人员能够根据业务需求创建更复杂的交互式电子邮件解决方案。例如，以编程方式包含附件的能力对于自动分发报告、发票或计划更新至关重要。

此外，集成这些高级功能需要了解 Graph API 的邮件项目综合模型，其中包括用于操作电子邮件组件的详细属性和方法。开发人员可以在很大程度上自定义电子邮件，例如嵌入丰富的 HTML 内容、自定义标头以及配置加密等安全设置。这种适应性使 MSGraph 成为企业环境中的强大工具，在企业环境中，电子邮件通信通常是工作流程自动化的关键部分。

有关 MSGraph 和 Python 的常见问题

  1. 问题： 如何在 Python 中向 Microsoft Graph API 进行身份验证？
  2. 回答： 可以使用 OAuth 2.0 协议进行身份验证。典型方法涉及从 Microsoft 身份平台端点获取访问令牌。
  3. 问题： 我可以在 Python 中使用 MSGraph 发送附件吗？
  4. 回答： 是的，您可以通过构建包含附件详细信息的适当 JSON 负载并使用 sendMail 方法来发送附件。
  5. 问题： 是否可以使用 MSGraph 发送 HTML 格式的电子邮件？
  6. 回答： 是的，Graph API 支持电子邮件中的 HTML 内容。您需要将电子邮件正文的 contentType 设置为 HTML。
  7. 问题： 如何使用 MSGraph 在电子邮件中添加抄送和密送收件人？
  8. 回答： 可以通过在消息对象的 ccRecipients 和 bccRecipients 字段中包含其电子邮件地址来添加抄送和密件抄送收件人。
  9. 问题： 我可以使用 MSGraph 阅读和处理传入的电子邮件吗？
  10. 回答： 是的，MSGraph 提供了从用户邮箱读取电子邮件的功能，然后可以根据需要对其进行处理或存储。

MSGraph 电子邮件自动化总结

通过探索 Microsoft Graph API 及其 Python SDK，开发人员配备了强大的工具来在应用程序中自动执行电子邮件操作。以编程方式管理电子邮件（包括附件和丰富的内容格式）的能力可以在企业内部实现更加动态和实用的通信策略。提供的示例和指南有助于确保顺利实施，使 MSGraph 成为在以 Microsoft 为中心的环境中工作的开发人员的宝贵资产。