修复 Gmail API PDF 附件问题的指南

使用 Python 解决 Gmail API 的 PDF 附件问题

通过 Gmail API 发送带有 PDF 附件的电子邮件的 Python 脚本

import base64
import os
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders
SCOPES = ['https://www.googleapis.com/auth/gmail.send']
creds = Credentials.from_authorized_user_file('token.json', SCOPES)
service = build('gmail', 'v1', credentials=creds)
message = MIMEMultipart()
message['to'] = 'myemail@test.com'
message['subject'] = 'Test Email with PDF Attachment'
message.attach(MIMEText('This is a test email with a PDF attachment.', 'plain'))
file_path = 'C:/Sites/documents/test.pdf'
with open(file_path, 'rb') as f:
    part = MIMEBase('application', 'octet-stream')
    part.set_payload(f.read())
encoders.encode_base64(part)
part.add_header('Content-Disposition', f'attachment; filename={os.path.basename(file_path)}')
message.attach(part)
raw_message = base64.urlsafe_b64encode(message.as_bytes()).decode()
try:
    message = {'raw': raw_message}
    send_message = (service.users().messages().send(userId="me", body=message).execute())
    print(f'Message Id: {send_message["id"]}') 
except HttpError as error:
    print(f'An error occurred: {error}')

使用 Gmail API 在 ColdFusion 中处理 PDF 附件

ColdFusion 脚本修复 PDF 附件问题

<cfscript>
try {
    manager_id_ = manager_id_;
    sqlQuery = "SELECT * FROM MANAGERS WHERE MANAGER_ID = :manager_id";
    tokenInfo = queryExecute(
        sql = sqlQuery,
        params = {manager_id: {value: manager_id_, cfsqltype: "cf_sql_integer"}},
        options = {datasource: "rugs_db", result: "result"}
    );
    if (tokenInfo.recordCount > 0) {
        accessToken = tokenInfo.GMAIL_TOKEN;
        toEmail = "myemail@test.com";
        subject = "Test Email with Attachments";
        bodyText = "This is a test email with attachments using ColdFusion and Gmail API.";
        attachment3FilePath = "C:/Sites/documents/test.pdf";
        attachment3FileContent = fileReadBinary(attachment3FilePath);
        attachment3FileName = "test.pdf";
        boundary = createUUID();
        mimeMessage = ["MIME-Version: 1.0", "to: " & toEmail, "subject: " & subject, "Content-Type: multipart/mixed; boundary=" & boundary, "", "--" & boundary, "Content-Type: text/plain; charset=UTF-8", "Content-Disposition: inline", "", bodyText, "", "--" & boundary, "Content-Type: application/pdf; name=""" & attachment3FileName & """", "Content-Transfer-Encoding: base64", "Content-Disposition: attachment; filename=""" & attachment3FileName & """", "", binaryEncode(attachment3FileContent, "base64"), "--" & boundary & "--"];
        mimeText = arrayToList(mimeMessage, chr(13) & chr(10));
        rawMessage = toBase64(mimeText);
        emailMessage = {"raw": rawMessage};
        cfhttp(method = "POST",
            url = "https://gmail.googleapis.com/gmail/v1/users/me/messages/send",
            charset = "UTF-8",
            result = "sendEmailResponse",
            timeout = 60,
            throwOnError = "true",
            resolveURL = "true") {
                cfhttpparam(type = "header", name = "Authorization", value = "Bearer " & accessToken);
                cfhttpparam(type = "header", name = "Content-Type", value = "application/json");
                cfhttpparam(type = "body", value = serializeJSON(emailMessage));
        }
        writeOutput("Email sent. Response: " & sendEmailResponse.filecontent);
    } else {
        writeOutput("No record found for Manager ID.");
    }
} catch (anye) {
    writeOutput("Error: " & e.message & "<br>");
    writeOutput("Details: " & e.detail & "<br>");
    if (isDefined("sendEmailResponse.statusCode")) {
        writeOutput("HTTP Status Code: " & sendEmailResponse.statusCode & "<br>");
        writeOutput("Response Headers: " & serializeJSON(sendEmailResponse.responseHeader) & "<br>");
        writeOutput("Response Body: " & sendEmailResponse.filecontent & "<br>");
    }
    writeDump(e);
}
</cfscript>

有关使用 Gmail API 发送电子邮件附件的常见问题和解答

1. 如何使用 Gmail API 发送带有 PDF 附件的电子邮件？
2. 使用带有 MIME 的 Gmail API 和 Base64 encoding 正确格式化并发送附件。
3. 为什么我的 PDF 附件无法通过 Gmail API 发送？
4. 确保 PDF 正确 encoded in Base64 并且 MIME 类型设置正确。
5. 我可以使用 Gmail API 在一封电子邮件中发送多个附件吗？
6. 是的，通过创建一个 MIMEMultipart 电子邮件，可以添加多个附件。
7. 如果我在发送带有附件的电子邮件时遇到错误，该怎么办？
8. 检查错误消息以了解详细信息，确保您的文件路径正确，并验证您的 access token 已验证。
9. Gmail API 中的电子邮件附件有大小限制吗？
10. 是的，电子邮件的总大小（包括附件）不应超过 25 MB。
11. 如何使用 Python 对附件进行 Base64 编码？
12. 以二进制方式读取文件并使用 base64.b64encode 对其进行编码。
13. 我可以将不同类型的文件（例如 PDF、DOCX、XLSX）作为附件发送吗？
14. 是的，确保每个文件正确 encoded in Base64 并且具有正确的 MIME 类型。
15. 使用 Gmail API 发送带附件的电子邮件时需要设置哪些标头？
16. 设置 Authorization 标头包含您的访问令牌和 17 号 标头到 application/json。
17. 使用 Gmail API 时如何处理身份验证？
18. 使用 OAuth 2.0 获取访问令牌并将其包含在您的 API 请求中。

关于 Gmail API 附件问题的最终想法

总之，使用 Gmail API 发送 PDF 等附件需要仔细处理 MIME 类型和 Base64 编码。常见问题是由不正确的编码或不正确的 MIME 类型声明引起的。通过实施提供的 Python 和 ColdFusion 脚本，您可以有效地排除和解决这些附件问题。确保您的附件编码正确，以在传输过程中保持数据完整性。了解这些概念将帮助您克服常见陷阱并成功将各种文件类型作为电子邮件附件发送。