在構建電子郵件自動化或歸檔解決方案時，程式化建立 EML 檔案是一項常見需求。
Aspose.Email Cloud SDK for Python 提供了一個強大的函式庫，簡化了 EML 產生、附件處理和自訂編碼。

在本指南中，您將一步步學習如何產生 EML 檔案、附加檔案與內嵌圖像、設定編碼，以及處理常見的 Bcc 和 Cc 欄位情境。

使用 Python 建立 EML 檔案的步驟

  1. 安裝 SDK - 執行 pip install aspose-email-cloud 以將函式庫加入您的環境。
  2. 驗證 - 使用您的 client ID 和 secret 建立 ApiClient 實例，然後取得存取權杖。請參閱 API 參考 了解 ApiClient 的詳細資訊。
  3. 建立 EmailDto - 填寫寄件者、收件者、主旨與內容欄位。使用 EmailDto 類別定義訊息結構。
  4. 加入附件或內嵌圖像 - 將 Attachment 物件附加至 EmailDto.attachments，或使用 EmailDto.body.html 搭配 CID 參考來放置內嵌內容。
  5. 儲存為 EML - 呼叫 email_api.create 並傳入 EmailDto，同時指定輸出格式為 EML。SDK 會回傳檔案串流，您可以將其寫入磁碟。

在 Python 中建立帶附件的 EML 檔案 - 完整程式碼範例

以下範例示範如何產生包含文字附件和內嵌圖像的 EML 檔案。

注意： 此程式碼範例展示了核心功能。在將其用於您的專案之前，請確保更新檔案路徑（image.png 等）以符合實際檔案位置，驗證所有必要的相依項目已正確安裝，並在開發環境中徹底測試。如遇任何問題，請參閱官方文件或聯繫支援團隊尋求協助。

透過 REST API 使用 cURL 產生 EML

您也可以透過 Aspose.Email Cloud REST API 產生 EML 檔案。以下步驟說明如何驗證、上傳來源檔案（如有需要）、建立訊息，並下載結果。

  1. 取得存取權杖
curl -X POST "https://api.aspose.cloud/v4.0/oauth2/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. 建立電子郵件 JSON 負載
cat <<EOF > email_payload.json
{
  "from": { "address": "sender@example.com", "displayName": "Sender" },
  "to": [{ "address": "recipient@example.com", "displayName": "Recipient" }],
  "subject": "cURL Generated EML",
  "body": "Generated via cURL with attachment.",
  "attachments": [
    {
      "name": "sample.txt",
      "contentBytes": "$(base64 sample.txt)"
    }
  ]
}
EOF
  1. 發送請求以建立 EML
curl -X POST "https://api.aspose.cloud/email/v4.0/email/create?format=EML" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d @email_payload.json \
     -o output.eml

如需了解請求結構的更多細節，請參閱 API 參考。

在 Python 中的安裝與設定

  • 確保已安裝 Python 3.7 以上版本。
  • 使用以下指令安裝 SDK：pip install aspose-email-cloud（請參閱下載頁面）。
  • 從 Aspose Cloud 儀表板取得您的 client ID 與 client secret。
  • （可選）使用以下 URL 申請測試用的臨時授權：臨時授權頁面。

Aspose.Email Cloud SDK for Python 的主要功能

  • EML 檔案產生器 支援純文字、HTML，以及豐富的 MIME 結構。
  • 直接處理 附件和內嵌圖像，無需手動構建 MIME。
  • 支援 自訂編碼（例如 UTF‑8、ISO‑8859‑1），以滿足國際化需求。
  • 能夠以程式方式設定 Bcc 與 Cc 欄位，確保收件人可見性正確。
  • 基於雲端的處理消除對本機 Outlook 或 Exchange 依賴的需求。

配置 Aspose.Email Cloud SDK 以生成 EML

全域或每次請求配置 SDK：

api_client = ApiClient(
    client_id="YOUR_CLIENT_ID",
    client_secret="YOUR_CLIENT_SECRET",
    base_url="https://api.aspose.cloud"
)
api_client.configuration.debug = True  # Enable detailed logging
email_api = EmailApi(api_client)

您也可以設定預設的 encoding：

email_api.configuration.default_encoding = "utf-8"

這些設定確保每個產生的 EML 都遵守您所需的字元集，並提供有用的診斷資訊。

處理附件與內嵌圖像（使用 Aspose.Email Cloud SDK）

  • 附件：使用 Attachment 物件並將其加入 EmailDto.attachments。SDK 會自動設定正確的 Content‑Type 和 Content‑Disposition。
  • 內嵌圖像：將附件標記為 is_inline=True，並在 HTML 內容中使用 cid:<content_id> 進行引用。例如：<img src="cid:image1"/>。
  • 大型檔案：使用串流方式傳送附件資料，而不是將整個檔案載入記憶體，以提升效能。

Aspose.Email Cloud SDK 的效能最佳化技巧

  • 重用 ApiClient 實例於多次電子郵件建立，以避免重複的驗證開銷。
  • 批次附件：在發送大量訊息時，僅上傳一次共享附件，並透過 ID 進行引用。
  • 啟用壓縮：設定 api_client.configuration.enable_compression = True 以減少大型 MIME 部分的有效負載大小。
  • 非同步呼叫：使用 SDK 的非同步方法（create_async）以提升高流量情境下的吞吐量。

在 Aspose.Email Cloud SDK 中排除常見錯誤

  • 驗證失敗 - 請確認您的 client ID/secret 正確，且 token URL 可訪問。
  • 行結尾問題 - SDK 會自動使用 CRLF (\r\n)。如果手動編輯 MIME 內容，請確保保留這些換行符。
  • 缺少 Bcc/Cc 欄位 - 再次確認您已在 EmailDto 上填充 bcc 和 cc 集合。
  • 附件大小限制 - 雲服務對每個請求限制為 100 MB；如有必要，請將大型檔案拆分為較小的部分。

使用 Aspose.Email Cloud SDK 產生 EML 檔案的最佳實踐

  • 使用明確的編碼 (utf-8) 以避免字元損壞，特別是非‑ASCII 內容。
  • 驗證電子郵件地址 在將其加入訊息之前，以防止伺服器端拒絕。
  • 偏好使用帶有正確換行符的 HTML 內容 (\r\n) 以提升與各種郵件客戶端的相容性。
  • 利用 SDK 的日誌功能 在開發過程中捕獲請求/回應細節。
  • 使用多個郵件客戶端測試（Outlook、Thunderbird、Gmail），確保產生的 EML 如預期顯示。

結論

使用 Aspose.Email Cloud SDK for Python 產生 EML 檔案在 Python 中變得相當簡單。本指南涵蓋了從安裝函式庫與驗證、建立郵件、加入附件到儲存訊息的完整工作流程。您也看到如何透過 cURL 使用 REST API 執行相同操作，學習了效能調校技巧，並探討了常見的故障排除情境。請記得在正式環境中套用有效的授權；您可以從 臨時授權頁面 取得永久授權或使用臨時授權。擁有這些工具後，您即可可靠地為任何電子郵件自動化專案產生符合規範的 EML 檔案。

常見問題

  • 將多個附件添加到 EML 檔案的最簡單方法是什麼？
    使用 EmailDto.attachments 列表，為每個檔案追加一個 Attachment 物件。SDK 會自動處理 MIME 邊界。請參閱 API 參考 了解 Attachment 類別。

  • 我可以在沒有網際網路連線的情況下產生 EML 檔案嗎？
    Aspose.Email Cloud SDK for Python 是一個基於雲端的函式庫，因此需要網際網路連線才能呼叫 Aspose 服務。若需離線情境，請考慮改用本機的 .NET 或 Java SDK。

  • 如何確保產生的 EML 符合 RFC 5322？
    SDK 會根據 RFC 標準驗證標頭格式和換行符。設定正確的 encoding 並使用提供的 MailAddress 物件有助於保持合規。

閱讀更多