Documentation – Làm việc với IMAP Client

Python-Net: Kết nối đến Máy chủ IMAP trong Python bằng Aspose.Email

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email cho Python thông qua .NET bao gồm ImapClient lớp, cho phép các nhà phát triển kết nối tới máy chủ thư bằng IMAP (Internet Message Access Protocol). Lớp này cho phép quản lý email bảo mật và hiệu quả trong các ứng dụng Python, bao gồm lấy, đọc, di chuyển, xóa và cập nhật các tin nhắn email.

Sử dụng client IMAP, bạn có thể xác thực người dùng, quản lý thư mục hộp thư, kết nối qua SSL, thiết lập thời gian chờ tùy chỉnh, và truy cập tài khoản email qua máy chủ proxy hoặc xác thực CRAM-MD5.

Kết nối IMAP Cơ bản

Để kết nối tới máy chủ IMAP bằng Aspose.Email, hãy làm theo ba bước đơn giản sau:

Tạo một đối tượng của ImapClient lớp.
Chỉ định tên máy chủ, cổng, tên người dùng và mật khẩu.
Chỉ định tùy chọn bảo mật mong muốn.

Mẫu mã dưới đây cho thấy cách kết nối tới máy chủ IMAP một cách lập trình:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd")

Bật SSL cho Kết nối IMAP

Để kết nối tới máy chủ IMAP hỗ trợ SSL, đặt security_options thuộc tính tới SSLImplicit:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd")

# Set the security mode to implicit
client.security_options = ae.clients.SecurityOptions.SSL_EXPLICIT

Kết nối qua Proxy SOCKS

Aspose.Email hỗ trợ các phiên bản SOCKS 4, 4a và 5 cho các kết nối qua proxy. Sử dụng các bước sau để kết nối qua proxy SOCKS:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", "username", "password")
client.security_options = ae.clients.SecurityOptions.AUTO

proxy = ae.clients.SocksProxy("192.168.203.142", 1080, ae.clients.SocksVersion.SOCKS_V5)
client.proxy = proxy

client.select_folder("Inbox")

Kết nối tới máy chủ qua HTTP Proxy

Aspose.Email cũng cho phép kết nối IMAP thông qua proxy HTTP:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", "username", "password")
client.proxy = ae.clients.HttpProxy("18.222.124.59", 8080)
client.select_folder("Inbox")

Truy cập Hộp thư Chỉ Đọc

Để ngăn thay đổi nội dung hộp thư, bật chế độ chỉ đọc. Thuộc tính read_only thuộc tính được đặt thành True cho biết không cho phép thay đổi. Mẫu mã dưới đây cho thấy cách sử dụng thuộc tính này trong dự án:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd")
client.security_options = ae.clients.SecurityOptions.SSL_EXPLICIT
client.read_only = True

Sử dụng Xác thực CRAM-MD5

Để tăng cường bảo mật, cấu hình client sử dụng xác thực CRAM-MD5:

Mẫu mã dưới đây trình bày cách cấu hình client để chấp nhận CRAM-MD5 như một trong các phương pháp xác thực được hỗ trợ khi kết nối tới máy chủ IMAP:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd")
client.allowed_authentication = ae.clients.imap.ImapKnownAuthenticationType.CRAM_MD5

Đặt Thời gian chờ Hoạt động

Ngăn client chờ vô hạn bằng cách đặt thời gian chờ (theo mili giây):

Đoạn mã sau đây cho thấy cách đặt thời gian chờ 60.000 mili giây (60 giây) để client chờ phản hồi từ server:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)
#  60 seconds
client.timeout = 60000

Đặt Thời gian chờ Lời chào

Kiểm soát thời gian client chờ trong quá trình bắt tay ban đầu với máy chủ thư.

Đoạn mã sau đây cho thấy cách giới hạn thời gian chờ lời chào bằng thuộc tính greeting_timeout của ImapClient lớp:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd")

client.greeting_timeout = 4000
client.select_folder(ae.clients.imap.ImapFolderInfo.IN_BOX)

Sử dụng TLS với Client IMAP

Aspose.Email hỗ trợ TLS và SSL cho giao tiếp bảo mật. Sử dụng supported_encryption thuộc tính để định nghĩa các phiên bản giao thức chấp nhận được.

LƯU Ý: bạn chỉ có thể đặt những phiên bản giao thức mà .net framework hỗ trợ. Nếu một số phiên bản giao thức không được hỗ trợ bởi phiên bản .NET framework hiện tại của bạn, chúng sẽ bị bỏ qua. Điều này có thể dẫn đến hạ cấp mức bảo mật TLS. Trong trường hợp này, không có ngoại lệ được tạo ra. Vui lòng sử dụng phương thức ‘set_supported_encryption_unsafe(value)’ nếu bạn muốn đặt các giao thức mà không có kiểm tra tính tương thích.

Ví dụ mã dưới đây cho bạn cách thiết lập TLS 1.3 cho ImapClient đối tượng lớp.

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS13

Trong trường hợp một giao thức mã hoá được chỉ định không được hỗ trợ trong phiên bản .NET Framework hiện tại, sự khác biệt về hành vi giữa phương thức set_supported_encryption_unsafe(value) và thuộc tính supported_encryption như sau:

Nếu thuộc tính supported_encryption được sử dụng, client email sẽ hạ cấp giao thức mã hoá xuống mức được hỗ trợ.
Nếu phương thức set_supported_encryption_unsafe(value) được sử dụng, client email sẽ ném ra các ngoại lệ.

Xác thực Thông tin Đăng nhập Máy chủ IMAP

Để thiết lập kết nối bảo mật tới máy chủ IMAP trước khi thực hiện các hành động tiếp theo, thông tin đăng nhập người dùng được kiểm tra và xác thực. Phương thức validate_credentials của ImapClient lớp giúp kiểm tra xem tên người dùng và mật khẩu đã cung cấp có đúng hay không. Nếu thông tin xác thực thực sự hợp lệ, client có thể xác thực thành công với máy chủ IMAP. Mẫu mã dưới đây cho thấy cách triển khai phương pháp này vào dự án của bạn:

import aspose.email as ae

with ae.clients.imap.ImapClient("your imap server", 993, "your username", "your password", ae.clients.SecurityOptions.AUTO) as client:
    client.timeout = 4000

    if client.validate_credentials():
        # Further actions

Bật Ghi nhật ký Hoạt động IMAP

Ghi nhật ký hoạt động bao gồm ghi lại các kết nối máy chủ, chi tiết truyền tải của các tin nhắn đã gửi và nhận, thông báo lỗi trong quá trình xử lý email, và bất kỳ hành động nào khác được thực hiện bởi client hoặc server. Để theo dõi hoạt động của client IMAP và các tương tác với server, sử dụng mẫu mã sau đây sử dụng thuộc tính log_file_name của ImapClient lớp để ghi thông tin vào tệp nhật ký được chỉ định:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

# Set the path to the log file using the LogFileName property.
client.log_file_name = "C:\\Aspose.Email.IMAP.log"
# Set the UseDateInLogFileName property if it is necessary.
client.use_date_in_log_file_name = False

Python-Net: Xóa email từ máy chủ IMAP trong môi trường Python

Mon, 01 Jan 0001 00:00:00 +0000

Xóa một tin nhắn duy nhất khỏi máy chủ

Để xóa một tin nhắn từ máy chủ IMAP, thư viện Aspose.Email cung cấp phương thức delete_message của ImapClient lớp. Nó nhận số thứ tự tin nhắn hoặc ID duy nhất làm tham số. Đoạn mã sau cho bạn thấy cách xóa một tin nhắn email có ID 1 từ máy chủ IMAP:

Xóa nhiều tin nhắn khỏi máy chủ

Nhiều email có thể được xóa khỏi hộp thư bằng phương thức delete_messages của ImapClient lớp được cung cấp bởi API Aspose.Email. Phương pháp này cung cấp nhiều tùy chọn để xóa nhiều tin nhắn khỏi máy chủ bằng cách sử dụng ID duy nhất, số thứ tự hoặc các phần tử ImapMessageInfoCollection. Đoạn mã sau cho bạn thấy cách xóa nhiều tin nhắn:

Python-Net: Tìm kiếm và lọc email IMAP trong Python bằng Aspose.Email

Mon, 01 Jan 0001 00:00:00 +0000

Để lấy tất cả tin nhắn từ một hộp thư, Aspose.Email cung cấp phương thức ’list_messages’ của ImapClient lớp. Để chỉ lấy những tin nhắn thỏa mãn các điều kiện nhất định, bạn có thể sử dụng phương thức ’list_messages’ được overload và chấp nhận một MailQuery được truyền làm đối số. Các MailQuery lớp cung cấp nhiều thuộc tính để định nghĩa các điều kiện này, như ngày, tiêu đề, người gửi và người nhận.

Mẫu mã đầu tiên minh họa cách lọc tin nhắn dựa trên cả ngày và tiêu đề. Các ví dụ bổ sung cho thấy việc lọc theo các tiêu chí khác và xây dựng các truy vấn phức tạp hơn. Hơn nữa, API hỗ trợ tiêu chí tìm kiếm phân biệt chữ hoa/thường để lọc chính xác và cho phép bạn chỉ định mã hoá của chuỗi tìm kiếm khi lọc tin nhắn từ hộp thư.

Lọc và lấy tin nhắn từ máy chủ IMAP

Xây dựng truy vấn IMAP đơn giản

Sử dụng đoạn mã sau để kết nối tới hộp thư IMAP và lấy các tin nhắn đã đến hôm nay và có từ "newsletter" trong tiêu đề.

Kết nối tới máy chủ IMAP bằng cổng 993 cùng tên người dùng và mật khẩu.
Chọn thư mục "Inbox" để làm việc với email đến.
Tạo một thể hiện của ImapQueryBuilder để xây dựng truy vấn tìm kiếm.
Xác định tiêu chí tìm kiếm, ví dụ, tiêu đề email phải chứa "Newsletter" và ngày nội bộ phải trùng với ngày hôm nay.
Tạo truy vấn tìm kiếm bằng cách lấy nó từ trình xây dựng.
Sử dụng truy vấn để liệt kê các tin nhắn đáp ứng tiêu chí.
In tổng số tin nhắn phù hợp với tiêu chí tìm kiếm.

Xây dựng Tiêu chí Tìm kiếm Phức tạp

Aspose.Email cũng cho phép xây dựng tiêu chí tìm kiếm phức tạp để truy vấn và lọc các tin nhắn email như ngày giao, trong một khoảng thời gian, người gửi cụ thể, miền cụ thể hoặc người nhận cụ thể. Đối với mục đích này, sử dụng MailQueryBuilder lớp và các thuộc tính của nó. Các mẫu mã dưới đây sẽ cho bạn cách lấy tin nhắn theo tiêu chí cụ thể.

Lọc Email theo Ngày Hôm Nay

Để lấy các tin nhắn theo ngày giao, sử dụng thuộc tính ‘internal_date’ của MailQueryBuilder lớp như được minh họa trong đoạn mã mẫu dưới đây:

import aspose.email as ae
from datetime import datetime

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.on(datetime.now())

Lọc email theo khoảng ngày

Để lấy tin nhắn trong một khoảng thời gian, sử dụng cùng thuộc tính ‘internal_date’ chỉ định khoảng ngày như trong đoạn mã mẫu dưới đây:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
# Emails that arrived in last 7 days
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))

Lọc Email theo Người gửi Cụ thể

Để lấy tin nhắn từ người gửi cụ thể, sử dụng thuộc tính ‘from_address’ của MailQueryBuilder lớp như được minh họa trong đoạn mã mẫu dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("saqib.razzaq@127.0.0.1")

Lọc email theo miền cụ thể

Để lấy tin nhắn từ một miền cụ thể, sử dụng thuộc tính ‘from_address’ như trong đoạn mã mẫu dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("SpecificHost.com")

Lọc email theo người nhận cụ thể

Để lấy tin nhắn gửi tới một người nhận cụ thể, sử dụng thuộc tính ’to’ như trong đoạn mã mẫu dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.to.contains("recipient")

Lọc tin nhắn theo ngày nội bộ

Xây dựng truy vấn dựa trên các điều kiện đã chỉ định như "ngày nội bộ" và "tiêu đề chứa". "Ngày nội bộ" đề cập đến ngày và thời gian mà một tin nhắn email được nhận hoặc thêm vào máy chủ email và có thể được đặt bằng thuộc tính ‘internal_date’ của ImapQueryBuilder lớp. Đoạn mã dưới đây minh họa cách lấy các email cụ thể từ hộp đến dựa trên tiêu đề và tiêu chí ngày:

import aspose.email as ae
from datetime import datetime

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd")
client.select_folder("Inbox")

# Set conditions, Subject contains "Newsletter", Emails that arrived today
builder = ae.clients.imap.ImapQueryBuilder()
builder.subject.contains("Newsletter")
builder.internal_date.on(datetime.now())

# Build the query and Get list of messages
query = builder.get_query()
messages = client.list_messages(query)
for info in messages:
    print(f"Internal Date: {info.internal_date}")

Lọc tin nhắn theo cờ từ khóa tùy chỉnh

Tạo một truy vấn để tìm trong hộp thư IMAP các email chứa cờ từ khóa tùy chỉnh, cụ thể là "custom1" và "custom2". Để xây dựng truy vấn, sử dụng ImapQueryBuilder lớp lọc email khi lấy chúng từ máy chủ IMAP.

Đầu tiên, tạo một thể hiện của trình xây dựng truy vấn. Sử dụng has_flags phương pháp, thêm các điều kiện để chỉ bao gồm những email mang cờ từ khóa IMAP đã chỉ định. Các từ khóa tùy chỉnh trong IMAP, còn gọi là cờ do người dùng định nghĩa, cho phép người dùng gắn thẻ hoặc phân loại email cho nhiều mục đích, như đánh dấu trạng thái.

Đoạn mã dưới đây minh họa cách tạo truy vấn để lấy email dựa trên cờ từ khóa tùy chỉnh:


builder = ae.clients.imap.ImapQueryBuilder()
builder.has_flags(ae.clients.imap.ImapMessageFlags.keyword("custom1"))
builder.has_flags(ae.clients.imap.ImapMessageFlags.keyword("custom2"))

Xây Dựng Truy Vấn Phức Tạp

Đôi khi cần thỏa mãn hơn một truy vấn. Aspose.Email cho phép điều này bằng cách kết hợp các truy vấn trong nhiều câu lệnh. Tạo một MailQueryBuilder đối tượng và sử dụng các thuộc tính của nó để xây dựng các truy vấn cụ thể.

Kết Hợp Truy Vấn với AND

Đoạn mã sau cho bạn thấy cách kết hợp các truy vấn bằng AND.

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))
builder.from_address.contains("SpecificHost.com")

Kết Hợp Truy Vấn với OR

Đoạn mã mẫu sau cho bạn cách kết hợp các truy vấn với OR.


builder.either(builder.subject.contains("test"), builder.from_address.contains("noreply@host.com"))

Áp dụng bộ lọc phân biệt chữ hoa chữ thường

API cũng cung cấp khả năng lọc email từ hộp thư dựa trên tiêu chí phân biệt chữ hoa chữ thường. Các phương thức sau của StringComparisonField lớp cung cấp khả năng tìm kiếm email với cờ phân biệt chữ hoa chữ thường.

StringComparisonField.contains(value, ignore_case)
StringComparisonField.equals(value, ignore_case)
StringComparisonField.not_contains(value, ignore_case)
StringComparisonField.not_equals(value, ignore_case)

Đoạn mã mẫu sau cho thấy cách triển khai khả năng này vào dự án của bạn:


builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("noreply@host.com", True)

Thực hiện truy vấn tìm kiếm tùy chỉnh

Tạo một truy vấn tìm kiếm cho hộp thư IMAP mà lọc email dựa trên tiêu chí tìm kiếm Gmail tùy chỉnh — cụ thể là các email có đính kèm.

Bắt đầu bằng cách tạo một thể hiện của ImapQueryBuilder, giúp xây dựng các truy vấn tìm kiếm IMAP phức tạp. Sử dụng custom_search phương pháp để thêm chuỗi tìm kiếm đặc thù Gmail vào trình xây dựng truy vấn.

Chuỗi tìm kiếm X-GM-RAW "has:attachment" tận dụng thuộc tính IMAP mở rộng X-GM-RAW của Gmail, cho phép sử dụng cú pháp tìm kiếm mạnh mẽ của Gmail trong các truy vấn IMAP. Ở đây, toán tử has:attachment trả về tất cả email có đính kèm.

Đoạn mã sau minh họa cách lọc email để nhận tất cả tin nhắn có đính kèm:


builder = ae.clients.imap.ImapQueryBuilder()
builder.custom_search("X-GM-RAW \"has:attachment\"")

mailQuery = builder.get_query()

Phương thức này cho phép lọc nâng cao đặc thù Gmail để lấy các email mục tiêu.

Python-Net: Ghi nhật ký hoạt động ImapClient trong Python

Mon, 01 Jan 0001 00:00:00 +0000

Bật ghi nhật ký hoạt động

Ghi nhật ký hoạt động bao gồm ghi lại các kết nối máy chủ, chi tiết truyền tin nhắn được gửi và nhận, thông báo lỗi trong quá trình xử lý email, và bất kỳ hành động nào khác được thực hiện bởi client hoặc server. Để theo dõi hoạt động client IMAP và các tương tác với server, sử dụng đoạn mã sau đây sử dụng thuộc tính ’log_file_name’ của ImapClient lớp để ghi thông tin vào tệp nhật ký được chỉ định:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

# Set the path to the log file using the LogFileName property.
client.log_file_name = "C:\\Aspose.Email.IMAP.log"
# Set the UseDateInLogFileName property if it is necessary.
client.use_date_in_log_file_name = False

Python-Net: Liệt kê Tiện Ích Máy Chủ IMAP trong Python

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email ImapClient cho phép bạn lấy các tiện ích máy chủ được hỗ trợ bởi máy chủ thư như IDLE, UNSELECT, QUOTA và các tiện ích khác. Điều này giúp đảm bảo tính sẵn có của các tính năng cụ thể trước khi thực hiện các thao tác phụ thuộc vào chúng. Các get_capabilities() phương thức của ImapClient lớp trả về danh sách các loại tiện ích IMAP được hỗ trợ dưới dạng chuỗi. Đoạn mã dưới đây cho bạn thấy cách lấy danh sách các tiện ích IMAP:

Python-Net: Tính Năng Tiện Ích cho Client IMAP trong Python

Mon, 01 Jan 0001 00:00:00 +0000

Xác minh thông tin đăng nhập máy chủ thư

Để thiết lập kết nối bảo mật tới máy chủ IMAP trước khi thực hiện các hành động tiếp theo, thông tin đăng nhập người dùng được kiểm tra và xác thực. Phương thức ‘validate_credentials’ của ImapClient lớp giúp kiểm tra xem tên người dùng và mật khẩu đã cung cấp có đúng hay không. Nếu thông tin xác thực thực sự hợp lệ, client có thể xác thực thành công với máy chủ IMAP. Mẫu mã dưới đây cho thấy cách triển khai phương pháp này vào dự án của bạn:

import aspose.email as ae

with ae.clients.imap.ImapClient("your imap server", 993, "your username", "your password", ae.clients.SecurityOptions.AUTO) as client:
    client.timeout = 4000

    if client.validate_credentials():
        # To do something

Python-Net: Quản lý Thư Mục IMAP trong Python với Aspose.Email

Mon, 01 Jan 0001 00:00:00 +0000

Liệt Kê Thư Mục IMAP

Việc lấy thông tin thư mục từ máy chủ IMAP trở nên đơn giản với Aspose.Email. Thực hiện các bước dưới đây để lấy và làm việc với chi tiết thư mục:

Sử dụng phương thức list_folders() từ Aspose.Email ImapClient lớp. Phương thức này trả về một thể hiện của ImapFolderInfoCollection, chứa thông tin chi tiết về tất cả các thư mục.
Lặp qua ImapFolderInfoCollection đối tượng để truy cập thông tin về các thư mục riêng lẻ.
Lấy các thư mục con (tùy chọn). Phương thức list_folders() được nạp lại. Bạn có thể truyền tên thư mục làm tham số để lấy tập hợp các thư mục con cho thư mục đã chỉ định.

Đoạn mã dưới đây minh họa cách lấy thông tin thư mục từ máy chủ IMAP bằng phương pháp Aspose.Email:

Đổi Tên và Xóa Thư Mục

Aspose.Email cung cấp các phương thức của ImapClient lớp để quản lý các thư mục trên máy chủ email qua IMAP:

phương thức delete_folder - xóa vĩnh viễn thư mục và tất cả các tin nhắn chứa trong đó.
phương thức rename_folder - thay đổi tên thư mục mà không làm thay đổi nội dung bên trong.

Đoạn mã dưới đây cho thấy cách xóa hoặc đổi tên thư mục trên máy chủ IMAP một cách lập trình:

# Delete a folder and Rename a folder
client.delete_folder("foldername")
client.rename_folder("foldername", "newfoldername")

Tạo và Thêm Tin Nhắn vào Các Thư Mục Cụ Thể

Với API Aspose.Email, bạn có thể sử dụng MailMessage và ImapClient các lớp để thêm một tin nhắn mới vào thư mục. Đầu tiên, tạo một MailMessage đối tượng bằng cách chỉ định tiêu đề, người gửi và người nhận. Sau đó, đăng ký một thư mục và thêm tin nhắn vào đó. Đoạn mã dưới đây minh họa cách thêm một tin nhắn mới vào thư mục:

Khởi tạo client IMAP bằng cách sử dụng ImapClient lớp để kết nối tới máy chủ email của bạn. Cung cấp địa chỉ máy chủ, cổng, tên người dùng và mật khẩu.
Chọn thư mục mục tiêu nơi bạn muốn thêm tin nhắn mới, chẳng hạn "Inbox", bằng phương thức select_folder.
Tạo một email mới bằng cách sử dụng MailMessage lớp. Xác định người gửi, người nhận, tiêu đề và nội dung tin nhắn.
Đăng ký thư mục bằng phương thức subscribe_folder với tên thư mục.
Thêm tin nhắn mới tạo vào thư mục đã chọn bằng phương thức append_message, xác định tên thư mục và đối tượng tin nhắn.

Di chuyển Tin nhắn giữa Các Thư mục

Aspose.Email cho .NET cho phép di chuyển tin nhắn từ một thư mục hộp thư sang thư mục khác bằng cách sử dụng ImapClient API. Phương thức move_message sử dụng ID duy nhất của tin nhắn và tên thư mục đích để di chuyển tin nhắn tới thư mục đích. Đoạn mã dưới đây cho bạn thấy cách di chuyển tin nhắn giữa các thư mục:

Sao Chép Tin Nhắn Giữa Các Thư Mục

API Aspose.Email cho phép bạn sao chép tin nhắn từ một thư mục hộp thư sang thư mục khác một cách dễ dàng. Bạn có thể sao chép một tin nhắn hoặc nhiều tin nhắn bằng các phương thức copy_message và copy_messages. Phương thức copy_messages cho phép bạn chuyển nhiều tin nhắn từ thư mục nguồn sang thư mục đích trong hộp thư. Dưới đây là đoạn mã minh họa cách sao chép tin nhắn giữa các thư mục:

Làm Việc với Các Thư Mục Hộp Thư Đặc Biệt

Các hộp thư đặc biệt là các thư mục được định nghĩa trước trong hệ thống email, được thiết kế để xử lý các loại tin nhắn cụ thể, chẳng hạn như Sent, Drafts, Junk, Trash và Archive. Thư viện Aspose.Email đơn giản hoá việc truy cập các hộp thư này bằng cách gán các thuộc tính với vai trò và mục đích của chúng. Điều này cho phép client tự động phát hiện và hiển thị các thư mục này mà không cần bất kỳ sự can thiệp nào của người dùng.

Đoạn mã dưới đây minh họa cách lấy thông tin về các hộp thư đặc biệt chủ chốt (Inbox, Drafts, Junk, Sent, và Trash) bằng cách sử dụng các thuộc tính của ImapMailBoxInfo lớp và in chi tiết:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

mailboxInfo = client.mailbox_info
print(mailboxInfo.inbox)
print(mailboxInfo.draft_messages)
print(mailboxInfo.junk_messages)
print(mailboxInfo.sent_messages)
print(mailboxInfo.trash)

Truy Cập Thư Mục và Đọc Tin Nhắn Đệ Quy

ImapClient sử dụng phương pháp đệ quy để liệt kê các thư mục và thư mục con từ máy chủ IMAP. Phương pháp này cũng được dùng để đọc và lưu tin nhắn vào đĩa cục bộ ở định dạng MSG. Cả thư mục và tin nhắn đều được tạo và lưu trong cùng cấu trúc phân cấp như trên máy chủ IMAP. Dưới đây là đoạn mã minh họa cách lấy thư mục và tin nhắn một cách đệ quy:

import aspose.email as ae
import os

# Recursive method to get messages from folders and sub-folders
def list_messages_in_folder(folder_info, root_folder, client):
    # Create the folder on disk (same name as on the IMAP server)
    current_folder = os.path.join(root_folder, folder_info.name)
    os.makedirs(current_folder, exist_ok=True)

    # Read the messages from the current folder, if it is selectable
    if folder_info.selectable:
        # Send a status command to get folder info
        folder_info_status = client.get_folder_info(folder_info.name)
        print(
            f"{folder_info_status.name} folder selected. New messages: {folder_info_status.new_message_count}, "
            f"Total messages: {folder_info_status.total_message_count}"
        )

        # Select the current folder and list messages
        client.select_folder(folder_info.name)
        msg_info_coll = client.list_messages()
        print("Listing messages....")
        for msg_info in msg_info_coll:
            # Get subject and other properties of the message
            print("Subject:", msg_info.subject)
            print(
                f"Read: {msg_info.is_read}, Recent: {msg_info.recent}, Answered: {msg_info.answered}"
            )

            # Get rid of characters like ? and :, which should not be included in a file name
            # Save the message in MSG format
            file_name = (
                msg_info.subject.replace(":", " ").replace("?", " ")
                + "-"
                + str(msg_info.sequence_number)
                + ".msg"
            )
            msg = client.fetch_message(msg_info.sequence_number)
            msg.save(
                os.path.join(current_folder, file_name),
                ae.SaveOptions.default_msg_unicode,
            )
        print("============================\n")
    else:
        print(f"{folder_info.name} is not selectable.")

    try:
        # If this folder has sub-folders, call this method recursively to get messages
        folder_info_collection = client.list_folders(folder_info.name)
        for subfolder_info in folder_info_collection:
            list_messages_in_folder(subfolder_info, root_folder, client)
    except Exception:
        pass



client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

try:
    # The root folder (which will be created on disk) consists of host and username
    root_folder = f"{client.host}-{client.username}"

    # Create the root folder and list all the folders from the IMAP server
    os.makedirs(root_folder, exist_ok=True)
    folder_info_collection = client.list_folders()
    for folder_info in folder_info_collection:
        # Call the recursive method to read messages and get sub-folders
        list_messages_in_folder(folder_info, root_folder, client)
except Exception as ex:
        print("\n", ex)

print("\nDownloaded messages recursively from IMAP server.")

Sử Dụng MultiConnection cho Các Thao Tác Thư Mục Hàng Loạt

Aspose.Email cho phép cấu hình client để thiết lập nhiều kết nối đồng thời tới máy chủ IMAP. Điều này không nhất thiết tăng hiệu suất, nhưng là giải pháp đáng tin cậy cho các hoạt động đồng thời. Điều này đặc biệt hữu ích nếu client cần thực hiện nhiều nhiệm vụ cùng lúc, chẳng hạn lấy các thư mục email khác nhau, đồng bộ dữ liệu lớn, hoặc xử lý nhiều tin nhắn đồng thời.

Đoạn mã dưới đây cho thấy cách thiết lập nhiều kết nối tới máy chủ IMAP trong khi tải lên một bộ sưu tập email bằng phương thức ‘append_messages’ của ImapClient lớp:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
client.append_messages(messages)

Python-Net: Quản lý cờ tin nhắn IMAP trong Python với Aspose.Email

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email cho Python qua .NET cho phép bạn quản lý các cờ tin nhắn IMAP như Read, Answered, Deleted và Custom Keywords trực tiếp từ ứng dụng Python của bạn. Các cờ này giúp đánh dấu trạng thái hoặc tình trạng của tin nhắn email trong hộp thư và hữu ích cho việc xây dựng quy trình email có tổ chức.

Bài viết này bao gồm cách:

Đặt và xóa các cờ hệ thống IMAP chuẩn
Gán cờ từ khóa tùy chỉnh cho tin nhắn

Khóa phương thức được sử dụng:

change_message_flags()
remove_message_flags()
add_message_flags()

Các cờ được hỗ trợ:

Answered
Deleted
Draft
Flagged
IsRead
Recent
Cờ từ khóa tùy chỉnh

Đặt cờ tin nhắn IMAP

Sử dụng change_message_flags() phương thức của ImapClient lớp để áp dụng các cờ chuẩn như IsRead hoặc Deleted cho tin nhắn. Phương pháp này nhận một định danh tin nhắn (số thứ tự hoặc UID) và một hoặc nhiều cờ.

Đoạn mã sau cho bạn thấy cách đặt cờ tin nhắn trên máy chủ IMAP với Aspose.Email:

Xóa cờ tin nhắn

Bạn có thể bỏ cờ hệ thống hoặc tùy chỉnh bằng cách sử dụng remove_message_flags() phương thức của ImapClient lớp. Thông thường được dùng để bỏ đánh dấu tin nhắn là đã đọc hoặc đã xóa. Đoạn mã dưới đây minh họa cách bỏ cờ ‘is_read’ chỉ trong một dòng mã:

# Remove the 'is_read' flag from the message
client.remove_message_flags(1, ae.clients.imap.ImapMessageFlags.is_read)

Thêm cờ từ khóa tùy chỉnh vào tin nhắn IMAP

Aspose.Email cũng hỗ trợ gán cờ từ khóa tùy chỉnh bằng cách sử dụng add_message_flags() phương thức của ImapClient lớp. Những cờ do người dùng định nghĩa này có thể hữu ích cho việc phân loại hoặc quy tắc xử lý.

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

# Create a new message
message = ae.MailMessage("user@domain1.com", "user@domain2.com", "subject", "message")

# Append the message to the Inbox
uid = client.append_message(ae.clients.imap.ImapFolderInfo.IN_BOX, message)

# Add custom keyword flags to the message
client.add_message_flags(uid, ae.clients.imap.ImapMessageFlags.keyword("custom1") | ae.clients.imap.ImapMessageFlags.keyword("custom1_0"))

# Verify the presence of the custom keyword
client.select_folder(ae.clients.imap.ImapFolderInfo.IN_BOX)
messageInfos = client.ListMessages()

for inf in messageInfos:
  flags = inf.flags.split()
  if inf.contains_keyword("custom1"):
        print("Keyword found")

Python-Net: Lấy và Liệt kê Email từ Máy chủ IMAP trong Python

Mon, 01 Jan 0001 00:00:00 +0000

Liệt kê Tin nhắn từ Hộp thư

Phương thức ’list_messages’ của ImapClient lớp lấy danh sách tất cả tin nhắn từ thư mục hiện đang được chọn (trong trường hợp này là "Inbox"). Danh sách này chứa các đối tượng siêu dữ liệu tin nhắn, thường bao gồm thông tin như ID tin nhắn, số thứ tự, UID, và có thể có dữ liệu tóm tắt như tiêu đề hoặc thông tin người gửi.

Đoạn mã dưới đây minh họa cách truy xuất siêu dữ liệu tin nhắn từ Hộp đến, và in ra tổng số tin nhắn mà nó chứa:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

client.select_folder("Inbox")

messages = client.list_messages()
print(f"Total Messages: {len(messages)}")

Liệt kê Tin nhắn với Hỗ trợ Phân trang

Trong các trường hợp, khi máy chủ email chứa số lượng lớn tin nhắn trong hộp thư, thường muốn liệt kê hoặc truy xuất tin nhắn có hỗ trợ phân trang. Aspose.Email ImapClient lớp cho phép bạn truy xuất tin nhắn từ server với hỗ trợ phân trang.

Liệt kê Tin nhắn Đệ quy

Giao thức IMAP cho phép liệt kê đệ quy các tin nhắn từ một thư mục hộp thư. Nó cũng cho phép liệt kê tin nhắn từ các thư mục con của nó. Đoạn mã dưới đây minh họa cách liệt kê tin nhắn một cách đệ quy:

Liệt kê ID Tin nhắn MIME

Cái ImapMessageInfo lớp cung cấp cách tiện lợi để truy cập MIME MessageId nhằm xác định tin nhắn mà không cần trích xuất toàn bộ nội dung tin nhắn. Dưới đây là đoạn mã minh họa cách liệt kê MIME MessageId:

Liệt kê Tin nhắn với MultiConnection

Cái ImapClient lớp cung cấp thuộc tính use_multi_connection, cho phép sử dụng nhiều kết nối cho các thao tác tải nặng. Ngoài ra, bạn có thể chỉ định số lượng kết nối trong chế độ đa kết nối bằng thuộc tính connections_quantity. Đoạn mã sau đây minh họa cách sử dụng chế độ đa kết nối để liệt kê tin nhắn:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

client.select_folder("Inbox")
client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE

message_info_col = client.list_messages(True)

Lưu ý rằng việc sử dụng chế độ này không nhất thiết dẫn đến tăng hiệu suất.

Lấy Tin nhắn theo Số Thứ tự hoặc ID Duy nhất

API Aspose.Email cho phép bạn tạo hai danh sách tin nhắn, một chứa số thứ tự và một chứa ID duy nhất của tất cả các tin nhắn trong hộp đến. Để lấy tin nhắn từ máy chủ IMAP theo định danh của chúng, sử dụng phương thức fetch_messages của ImapClient lớp. Đoạn mã dưới đây minh họa cách liệt kê tin nhắn theo định danh:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

# List messages
message_info_col = client.list_messages()
print("ListMessages Count:", message_info_col.count)

# Get sequence numbers and unique IDs
sequence_number_ar = [mi.sequence_number for mi in message_info_col]
unique_id_ar = [mi.unique_id for mi in message_info_col]

# Fetch messages by sequence number
fetched_messages_by_snum = client.fetch_messages(sequence_number_ar)
print("FetchMessages-sequenceNumberAr Count:", len(fetched_messages_by_snum))

# Fetch messages by UID
fetched_messages_by_uid = client.fetch_messages(unique_id_ar)
print("FetchMessages-uniqueIdAr Count:", len(fetched_messages_by_uid))

Lấy Tin nhắn theo Thứ tự Giảm dần

Nhiệm vụ được thực hiện bằng cách định nghĩa cài đặt phân trang cho việc truy xuất tin nhắn. Đối với mục đích này, sử dụng thuộc tính ascending_sorting của PageSettings lớp là một phần của mô-đun client IMAP. Đặt thuộc tính ascending_sorting trên PageSettings đặt đối tượng thành False. Điều này cho biết tin nhắn sẽ được sắp xếp theo thứ tự giảm dần mặc định khi truy xuất. Đoạn mã sau đây cho thấy cách truy xuất tin nhắn theo thứ tự giảm dần:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

page_settings = ae.clients.imap.PageSettings
page_settings.ascending_sorting = False
page_info = client.list_messages_by_page(5, page_settings)
messages = page_info.items

for message in messages:
    print(message.subject)

Lấy Tin nhắn từ Server và Lưu lên Đĩa

Cái ImapClient lớp có thể lấy tin nhắn từ máy chủ IMAP và lưu chúng ở định dạng EML lên ổ đĩa cục bộ. Các bước sau cần thiết để lưu tin nhắn lên đĩa:

Sử dụng ImapClient lớp với các tham số cần thiết (host, port, username, password) để kết nối tới máy chủ IMAP.
Chọn thư mục mong muốn bằng cách gọi phương thức select_folder (ví dụ, "Inbox")
Truy xuất tin nhắn bằng cách lặp qua chúng sử dụng phương thức list_messages.
Để lưu tin nhắn, với mỗi tin nhắn, sử dụng phương thức save_message chỉ định thư mục, và nối ID duy nhất vào tên tệp để đảm bảo tính duy nhất.

Đoạn mã sau đây cho bạn cách lấy các tin nhắn email từ server và lưu chúng:

Lưu tin nhắn ở định dạng MSG

Để lưu email ở định dạng MSG, gọi phương thức fetch_message của ImapClient lớp. Nó trả về tin nhắn dưới dạng một thể hiện của MailMessage lớp. Phương thức MailMessage.save() sau đó có thể được gọi để lưu tin nhắn dưới dạng MSG. Đoạn mã sau đây cho bạn cách lưu tin nhắn ở Định dạng MSG.

Lấy Tham số Tin nhắn Bổ sung (Thông tin Tóm tắt)

Đoạn mã dưới đây minh họa cách tương tác với một máy chủ email bằng Aspose.Email ImapClient để gửi và thao tác các tin nhắn email. Mã sử dụng UID của tin nhắn để truy xuất thông tin tóm tắt với các tham số bổ sung ("X-GM-MSGID", "X-GM-THRID"). Thông tin tương tự được truy xuất bằng số thứ tự.

Lấy Tiêu Đề List-Unsubscribe

Tiêu đề "ListUnsubscribe" thường được bao gồm trong các tiêu đề của email do các danh sách gửi thư hoặc hệ thống email tự động gửi. Nó cung cấp một liên kết hoặc địa chỉ email mà người nhận có thể dùng để hủy đăng ký khỏi danh sách gửi thư hoặc các email tự động. Aspose.Email cung cấp thuộc tính ’list_unsubscribe’ của ImapMessageInfo lớp để lấy tiêu đề này. Đoạn mã dưới đây minh họa cách sử dụng thuộc tính và có thể được dùng như một phần của hệ thống để tự động hoá quá trình hủy đăng ký khỏi các email không mong muốn:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

message_info_col = client.list_messages()

# Iterate through each message
for imap_message_info in message_info_col:
    print("ListUnsubscribe Header:", imap_message_info.list_unsubscribe)

Lấy Thông Tin Định Danh Tin Nhắn

Khi truy xuất và xử lý các tin nhắn email, bạn có thể lấy chi tiết tin nhắn bằng cách sử dụng số thứ tự của chúng.

Các tính năng sau được sử dụng để tương tác với hộp thư IMAP:

Aspose.Email.ImapMessageInfo lớp - Đại diện cho thông tin định danh về tin nhắn trong một hộp thư.
Aspose.Email.ImapMessageInfo.sequence_number thuộc tính - Số thứ tự của một tin nhắn.
Aspose.Email.ImapMessageInfo.unique_id thuộc tính - ID duy nhất của một tin nhắn.

Đoạn mã dưới đây cho thấy cách lấy thông tin định danh về tin nhắn:

import aspose.email as ae

client = ae.clients.imap.ImapClient("imap.domain.com", 993, "user@domain.com", "pwd", ae.clients.SecurityOptions.SSL_IMPLICIT)

msg_infos = client.list_messages("INBOX")

for msg_info in msg_infos:
    # fetch by sequence number
    msg = client.fetch_message(msg_info.sequence_number)

    # fetch by unique id
    msg = client.fetch_message(msg_info.unique_id)

Liệt kê Tệp đính kèm từ Tin nhắn Email IMAP

Để lấy thông tin về tệp đính kèm như tên, kích thước mà không tải dữ liệu tệp, sử dụng các tài nguyên thư viện sau:

ImapAttachmentInfo lớp - Đại diện cho thông tin tệp đính kèm (kích thước, tên, loại media).
ImapAttachmentInfoCollection lớp - Đại diện cho tập hợp của ImapAttachmentInfo.
phương thức list_attachments(sequence_number) của ImapClient lớp - Lấy một iterable hoặc collection chứa thông tin tệp đính kèm cho tin nhắn.

Mẫu mã dưới đây minh họa cách liệt kê tệp đính kèm cho mỗi tin nhắn email bằng Aspose.Email ImapClient:

# List messages
message_info_col = client.list_messages()

# Iterate through each message
for message_info in message_info_col:
    print(f"Attachments for message with sequence number {message_info.sequence_number}:")

    # List attachments for the current message
    attachment_info_col = client.list_attachments(message_info.sequence_number)

    # Iterate through each attachment
    for attachment_info in attachment_info_col:
        print(f"Attachment: {attachment_info.name} (size: {attachment_info.size})")

Python-Net: Kích hoạt Tiện Ích IMAP bằng API Python

Mon, 01 Jan 0001 00:00:00 +0000

Hỗ Trợ Tiện Ích IMAP

API Aspose.Email cung cấp hỗ trợ cho một loạt các tiện ích giao thức IMAP. Các tiện ích này cho phép các thao tác nâng cao như xác định ứng dụng khách và lấy siêu dữ liệu chi tiết của hộp thư. Mặc dù không phải tất cả các máy chủ email đều hỗ trợ các tính năng này, nhưng nhiều dịch vụ phổ biến như Gmail vẫn hỗ trợ.

Bài viết này minh họa cách sử dụng các tiện ích IMAP sau với ImapClient lớp trong Aspose.Email:

Lệnh IMAP ID
Lệnh IMAP LIST-EXTENDED

Sử Dụng Lệnh IMAP ID

Lệnh này cung cấp phản hồi về việc máy chủ có hỗ trợ tiện ích IMAP ID hay không và trả về chi tiết định danh có cấu trúc từ máy chủ. Điều này có thể hữu ích cho việc ghi log, chẩn đoán và tùy chỉnh hành vi của máy chủ.

Đoạn mã mẫu dưới đây minh họa cách sử dụng thư viện Aspose.Email để tương tác với máy chủ IMAP, cụ thể là để lấy thông tin định danh máy chủ bằng lệnh ID:

import aspose.email as ae

with ae.clients.imap.ImapClient("imap.gmail.com", 993, "username", "password") as client:

    # Set security options
    client.security_options = ae.clients.SecurityOptions.AUTO

    # Check if ID command is supported
    print(client.id_supported)

    # Send identification info to the server
    server_identification_info1 = client.introduce_client()
    server_identification_info2 = client.introduce_client(ae.clients.imap.ImapIdentificationInfo.default_value)

    # Display server response
    print(server_identification_info1)
    print(server_identification_info2)
    print(server_identification_info1.name)
    print(server_identification_info1.vendor)
    print(server_identification_info1.support_url)
    print(server_identification_info1.version)

Sử Dụng Lệnh IMAP LIST-EXTENDED

Lệnh IMAP LIST-EXTENDED (được định nghĩa trong RFC 5258) cho phép khách hàng lấy chi tiết cấu trúc thư mục và siêu dữ liệu, chẳng hạn như liệu thư mục có thư mục con hay không. Điều này đặc biệt hữu ích cho các khách hàng quản lý cấu trúc hộp thư phức tạp.

Đoạn mã mẫu dưới đây minh họa cách liệt kê các thư mục trong Gmail bằng lệnh LIST mở rộng và xác minh thư mục nào có thư mục con:

import aspose.email as ae

with ae.clients.imap.ImapClient("imap.gmail.com", 993, "username", "password") as client:
    folder_info_col = client.list_folders("*")
    print("Extended List Supported:", client.extended_list_supported)

    for folder_info in folder_info_col:
        folder_name = folder_info.name

        if folder_name == "[Gmail]/All Mail":
            print("Has Children:", folder_info.has_children)
        elif folder_name == "[Gmail]/Bin":
            print("Bin has children?", folder_info.has_children)
        elif folder_name == "[Gmail]/Drafts":
            print("Drafts has children?", folder_info.has_children)
        elif folder_name == "[Gmail]/Important":
            print("Important has Children?", folder_info.has_children)
        elif folder_name == "[Gmail]/Sent Mail":
            print("Sent Mail has Children?", folder_info.has_children)
        elif folder_name == "[Gmail]/Spam":
            print("Spam has Children?", folder_info.has_children)
        elif folder_name == "[Gmail]/Starred":
            print("Starred has Children?", folder_info.has_children)

Python-Net: Sao Lưu và Khôi Phục Tin Nhắn IMAP trong Python

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email cho Python cung cấp các phương thức của ImapClient lớp để quản lý tin nhắn email qua giao thức IMAP:

phương thức ‘backup’
phương thức ‘restore’

Bài viết này minh họa cách sử dụng ImapClient lớp và các phương thức của nó để sao lưu và khôi phục tin nhắn email vào và từ file PST. Nó cũng đề cập cách cải thiện hiệu năng cho các hộp thư lớn bằng chế độ đa kết nối.

Sao Lưu Tin Nhắn IMAP

Để tạo bản sao lưu các tin nhắn email từ máy chủ IMAP, sử dụng backup phương thức của ImapClient lớp. Đoạn mã mẫu dưới đây cho thấy cách sao lưu thư mục Inbox vào file .pst:

import aspose.email as ae

# Create an instance of the ImapClient class
imap_client = ae.clients.imap.ImapClient()

# Specify host, username, password, and set port for your client
imap_client.host = "imap.gmail.com"
imap_client.username = username
imap_client.password = password
imap_client.port = 993
imap_client.security_options = ae.clients.SecurityOptions.AUTO

# Get mailbox info
mailbox_info = imap_client.mailbox_info

# Get folder info for the Inbox folder
inbox_info = imap_client.get_folder_info(mailbox_info.inbox.name)

# Create an ImapFolderInfoCollection and add the Inbox folder info
infos = ae.clients.imap.ImapFolderInfoCollection()
infos.add(inbox_info)

# Specify the path to the directory
data_dir = "path/to/your/data/directory"

# Perform the backup operation
settings = ae.clients.imap.BackupSettings
settings.execute_recursively = True
imap_client.backup(infos, data_dir + "\\ImapBackup.pst", settings)

Khôi Phục Tin Nhắn IMAP

Để khôi phục tin nhắn từ file .pst trở lại máy chủ IMAP, sử dụng restore phương thức của ImapClient lớp:

import aspose.email as ae

# Create an instance of the ImapClient class
imap_client = ae.clients.imap.ImapClient()

# Specify host, username, password, and set port for your client
imap_client.host = "imap.gmail.com"
imap_client.username = username
imap_client.password = password
imap_client.port = 993
imap_client.security_options = ae.clients.SecurityOptions.Auto

# Create RestoreSettings with Recursive set to true
settings = ae.clients.imap.RestoreSettings()
settings.recursive = True

# Specify the path to the directory
data_dir = "path/to/your/data/directory"

# Load the PST file
pst = ae.storage.pst.PersonalStorage.from_file(data_dir + "\\ImapBackup.pst")

# Perform the restore operation
imap_client.restore(pst, settings)

Tăng Tốc Độ Với Chế Độ Đa Kết Nối

Đối với các nhiệm vụ liên quan đến lượng dữ liệu lớn hoặc nhiều tin nhắn email, Aspose.Email cung cấp thuộc tính ‘use_multi_connection’ của ImapClient lớp để tối ưu hiệu năng của các thao tác bằng cách cho phép client mở nhiều kết nối tới máy chủ email đồng thời. Khi MultiConnectionMode được bật, client IMAP có thể thực hiện các nhiệm vụ khác nhau (như lấy email, đồng bộ thư mục và sao lưu dữ liệu) song song trên các kết nối khác nhau. Điều này có thể giảm đáng kể thời gian tổng thể cần để hoàn thành các thao tác. Các đoạn mã sau đây minh họa cách bật MultiConnection chế độ cho các thao tác sao lưu và khôi phục.

Lưu ý: Việc sử dụng nhiều kết nối có thể bị giới hạn và chính sách do máy chủ email đặt ra. Một số máy chủ có thể áp đặt hạn chế về số lượng kết nối đồng thời có thể được tạo từ một tài khoản người dùng để tránh quá tải máy chủ. Luôn kiểm tra các điều khoản dịch vụ hoặc chính sách của nhà cung cấp email để đảm bảo tuân thủ các hướng dẫn sử dụng trước khi bật MultiConnectionMode.

Sao Lưu Tin Nhắn với MultiConnection Được Bật

Đoạn mã dưới đây minh họa cách thực hiện sao lưu với chế độ MultiConnection được bật:

import aspose.email as ae

# Create an instance of the ImapClient class
imap_client = ae.clients.imap.ImapClient()

# Specify host, username, password, and set port for your client
imap_client.host = "imap.gmail.com"
imap_client.username = username
imap_client.password = password
imap_client.port = 993
imap_client.security_options = ae.clients.SecurityOptions.Auto

# Enable MultiConnectionMode
imap_client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE

# Get mailbox info
mailbox_info = imap_client.mailbox_info

# Get folder info for the Inbox folder
inbox_info = imap_client.get_folder_info(mailbox_info.inbox.name)

# Create an ImapFolderInfoCollection and add the Inbox folder info
infos = ae.clients.imap.ImapFolderInfoCollection()
infos.add(inbox_info)

# Specify the path to the directory
data_dir = "path/to/your/data/directory"

# Perform the backup operation
settings = ae.clients.imap.BackupSettings
settings.execute_recursively = True
imap_client.backup(infos, data_dir + "\\ImapBackup.pst", settings)

Khôi phục Tin nhắn với MultiConnection

Đoạn mã dưới đây minh họa cách thực hiện thao tác khôi phục với chế độ MultiConnection được bật.

import aspose.email as ae

# Create an instance of the ImapClient class
imap_client = ae.clients.imap.ImapClient()

# Specify host, username, password, and set port for your client
imap_client.host = "imap.gmail.com"
imap_client.username = username
imap_client.password = password
imap_client.port = 993
imap_client.security_options = ae.clients.SecurityOptions.Auto

# Enable MultiConnectionMode
imap_client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE

# Create RestoreSettings with Recursive set to true
settings = ae.clients.imap.RestoreSettings()
settings.recursive = True

# Specify the path to the directory
data_dir = "path/to/your/data/directory"

# Load the PST file
pst = ae.storage.pst.PersonalStorage.from_file(data_dir + "\\Outlook.pst")

# Perform the restore operation
imap_client.restore(pst, settings)