Python邮箱API发送邮件时，如何添加附件并设置其属性？

蜂邮作者132年前 (2024-05-14)五款优秀的邮件群发平台,哪个更适合你?715

【蜂邮EDM】：EDM邮件营销平台，邮件群发系统，邮件代发服务。查看价格
 【AokSend邮件API】：触发式邮件API，99%送达率，15元/万封。查看价格
 【AOTsend】：Transaction Email API，$0.28/1000 Emails。查看价格

在Python中，我们通常使用内置的smtplib库和email模块来发送电子邮件。当我们需要向邮件中添加附件时，我们需要构建一个MIME（多用途互联网邮件扩展）消息，以便在邮件中包含非文本内容。MIME消息允许我们将不同的数据类型（如文本、图像、音频和视频）嵌入到电子邮件中。

下面是一个详细的步骤指南，介绍如何在Python中使用邮箱API发送带有附件的电子邮件，并设置附件的属性。

一、设置邮件服务器和SMTP连接

首先，我们需要设置邮件服务器的信息，并使用smtplib库建立与SMTP服务器的连接。SMTP（简单邮件传输协议）是用于发送电子邮件的协议。

python

import smtplib

from email.mime.multipart import MIMEMultipart

from email.mime.base import MIMEBase

from email.mime.text import MIMEText

from email.utils import formatdate

from email import encoders

# 邮件服务器设置

smtp_server = 'smtp.example.com'

smtp_port = 587 # 通常用于TLS加密的端口

smtp_username = 'your-email@example.com'

smtp_password = 'your-password'

# 连接到SMTP服务器

server = smtplib.SMTP(smtp_server, smtp_port)

server.starttls() # 启用TLS加密

server.login(smtp_username, smtp_password)

二、创建邮件消息

接下来，我们将创建一个MIME多部分消息，该消息将包含文本部分和附件部分。

python

# 创建邮件对象

msg = MIMEMultipart()

msg['From'] = smtp_username

msg['To'] = 'recipient@example.com'

msg['Date'] = formatdate(localtime=True)

msg['Subject'] = 'Email with attachment'

# 添加邮件正文

body = 'This is the email body with an attached file.'

msg.attach(MIMEText(body, 'plain'))

三、添加附件

要添加附件，我们需要创建一个MIMEBase对象，并使用encoders模块中的函数将其编码为可传输的格式。然后，我们将这个对象添加到邮件消息中。

python

# 读取附件文件

with open('attachment.pdf', 'rb') as f:

part = MIMEBase('application', 'octet-stream') # 通用二进制数据

part.set_payload(f.read())

# 编码附件并设置Content-Transfer-Encoding头部

encoders.encode_base64(part)

# 设置附件的文件名和描述性信息（可选）

🔔🔔🔔

【蜂邮EDM】：邮件群发系统，EDM邮件营销平台，邮件代发服务，专业研发定制邮件营销系统及邮件群发解决方案！蜂邮自研产品线主要分为标准版、外贸版、企业版、定制版，及邮件API邮件SMTP接口服务。
立即查看 >> ：邮件发送价格

【AokSend邮件API】：专注触发式邮件API发送服务。15元/万封，发送验证码邮件、忘记密码邮件、通知告警邮件等，不限速。综合送达率99%、进箱率98%。触发邮件也叫事务性邮件或推送邮件，包含：验证码邮件、重置密码邮件、余额提醒邮件、会员到期邮件、账号认证邮件等！
立即查看 >> ：邮件发送价格

【AotSend Email API】：AotSend is a Transaction Email API provider specializing in Safe-Stable email delivery. $0.28 per 1000 Emails. 99% Delivery, 98% Inbox Rate. AOT means Always On Time for email delivery.
立即查看 >> ：邮件发送价格

🔔🔔🔔

part.add_header('Content-Disposition', 'attachment', filename='attachment.pdf')

part.add_header('Content-ID', '<00001>') # 可以设置一个唯一的Content-ID

part.add_header('Content-Description', 'A PDF attachment') # 附件的描述性文本

# 将附件添加到邮件消息中

msg.attach(part)

在上面的代码中，我们首先使用open函数以二进制模式（'rb'）打开附件文件。然后，我们创建一个MIMEBase对象，并指定MIME类型为application/octet-stream，这是一个通用的二进制数据类型。接下来，我们使用set_payload方法将文件内容设置为MIME对象的负载。

然后，我们使用encoders.encode_base64函数对MIME对象进行Base64编码，这是SMTP服务器要求的格式。我们还需要使用add_header方法设置一些额外的头部信息，如Content-Disposition（指定附件的文件名和如何显示它）、Content-ID（一个可选的唯一标识符）和Content-Description（附件的描述性文本）。

最后，我们将编码并设置头部后的MIME对象添加到邮件消息中。

四、发送邮件并关闭连接

现在我们已经构建了完整的邮件消息，包括文本正文和附件。我们可以使用SMTP服务器的sendmail方法发送邮件。

python