Documentation – IMAP 클라이언트 작업

Python-Net: Aspose.Email을 사용하여 파이썬에서 IMAP 서버에 연결하기

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

Aspose.Email for Python via .NET은 다음을 포함합니다 ImapClient 클래스는 개발자들이 IMAP(Internet Message Access Protocol)를 사용하여 메일 서버에 연결하도록 허용합니다. 이 클래스는 파이썬 애플리케이션 내에서 이메일을 검색, 읽기, 이동, 삭제 및 업데이트하는 등 안전하고 효율적인 이메일 관리를 가능하게 합니다.

IMAP 클라이언트를 사용하면 사용자를 인증하고, 메일함 폴더를 관리하며, SSL을 통해 연결하고, 사용자 지정 타임아웃을 설정하며, 프록시 서버 또는 CRAM-MD5 인증을 통해 이메일 계정에 접근할 수 있습니다.

기본 IMAP 연결

Aspose.Email을 사용하여 IMAP 서버에 연결하려면, 다음 세 가지 간단한 단계를 따르세요:

다음의 인스턴스를 생성합니다. ImapClient 클래스.
호스트 이름, 포트, 사용자 이름 및 비밀번호를 지정하십시오.
원하는 보안 옵션을 지정하십시오.

아래 코드 샘플은 프로그래밍 방식으로 IMAP 서버에 연결하는 방법을 보여줍니다:

import aspose.email as ae

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

IMAP 연결에 SSL 활성화

SSL이 활성화된 IMAP 서버에 연결하려면, 다음을 설정하십시오 security_options 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

SOCKS 프록시를 통한 연결

Aspose.Email은 프록시 기반 연결을 위해 SOCKS 버전 4, 4a, 5를 지원합니다. 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")

HTTP 프록시를 통한 서버 연결

Aspose.Email은 HTTP 프록시를 통한 IMAP 연결도 허용합니다:

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")

읽기 전용 메일함 접근

메일함 내용의 변경을 방지하려면 읽기 전용 모드를 활성화하십시오. 해당 read_only True 로 설정된 속성은 변경이 허용되지 않음을 나타냅니다. 다음 코드 샘플은 프로젝트에서 이 속성을 사용하는 방법을 보여줍니다:

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

CRAM-MD5 인증 사용

보안을 강화하기 위해 클라이언트가 CRAM-MD5 인증을 사용하도록 구성합니다:

다음 코드 샘플은 IMAP 서버에 연결하기 위한 지원 인증 방법 중 하나로 CRAM-MD5를 허용하도록 클라이언트를 구성하는 방법을 보여줍니다:

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

작업 타임아웃 설정

타임아웃(밀리초)을 설정하여 클라이언트가 무한히 대기하지 않도록 방지합니다:

다음 코드 스니펫은 클라이언트가 서버 응답을 기다리는 타임아웃 기간을 60,000밀리초(60초)로 설정하는 방법을 보여줍니다:

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

인사 타임아웃 설정

클라이언트가 메일 서버와 초기 핸드쉐이크를 수행할 때 대기하는 시간을 제어합니다.

다음 코드 스니펫은 greeting_timeout 속성을 사용하여 인사(greeting) 타임아웃을 제한하는 방법을 보여줍니다. ImapClient 클래스:

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)

IMAP 클라이언트와 TLS 사용

Aspose.Email은 보안 통신을 위해 TLS 및 SSL을 지원합니다. 다음을 사용하십시오 supported_encryption 허용 가능한 프로토콜 버전을 정의하는 속성.

NOTE: .net framework에서 지원하는 프로토콜 버전만 설정할 수 있습니다. 현재 .NET framework 버전이 지원하지 않는 프로토콜 버전은 무시되고 건너뛰어집니다. 이는 TLS 보안 수준이 낮아질 수 있습니다. 이 경우 예외가 발생하지 않습니다. 호환성 검사를 하지 않고 프로토콜을 설정하려면 ‘set_supported_encryption_unsafe(value)’ 메서드를 사용하십시오.

아래 코드 예제는 TLS 1.3을 설정하는 방법을 보여줍니다 ImapClient 클래스 인스턴스.

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

현재 .NET Framework 버전에서 지정된 암호화 프로토콜이 지원되지 않을 경우, set_supported_encryption_unsafe(value) 메서드와 supported_encryption 속성 간 동작 차이는 다음과 같습니다:

supported_encryption 속성을 사용하면 이메일 클라이언트가 암호화 프로토콜을 지원되는 수준으로 낮춥니다.
set_supported_encryption_unsafe(value) 메서드를 사용하면 이메일 클라이언트가 예외를 발생시킵니다.

IMAP 서버 자격 증명 검증

추가 작업을 수행하기 전에 IMAP 서버에 보안 연결을 설정하려면 사용자 자격 증명을 확인하고 검증합니다. 해당 클래스의 validate_credentials 메서드 ImapClient 클래스는 제공된 사용자 이름과 비밀번호가 올바른지 확인하는 데 도움을 줍니다. 자격 증명이 유효하면 클라이언트는 IMAP 서버에 성공적으로 인증할 수 있습니다. 다음 코드 샘플은 이 메서드를 프로젝트에 구현하는 방법을 보여줍니다:

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

IMAP 활동 로깅 활성화

활동 로깅은 서버 연결, 전송 및 수신된 메시지의 전송 세부 정보, 이메일 처리 중 오류 메시지, 클라이언트 또는 서버가 수행한 기타 모든 작업을 기록하는 것을 포함합니다. IMAP 클라이언트 활동 및 서버와의 상호 작용을 추적하려면, 다음 코드 샘플에서 log_file_name 속성을 사용하는 ImapClient 지정된 로그 파일에 정보를 기록하는 클래스:

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: Python 환경에서 IMAP 서버의 이메일 삭제

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

서버에서 단일 메시지 삭제

IMAP 서버에서 메시지를 삭제하려면, Aspose.Email 라이브러리는 delete_message 메서드를 제공합니다 ImapClient 클래스. 메시지 시퀀스 번호 또는 고유 ID를 매개변수로 받습니다. 다음 코드 스니펫은 메시지 ID 1을 가진 이메일을 IMAP 서버에서 삭제하는 방법을 보여줍니다:

서버에서 다중 메시지 삭제

메일함에서 여러 이메일을 삭제하려면 delete_messages 메서드를 사용할 수 있습니다 ImapClient Aspose.Email API가 제공하는 클래스입니다. 이 메서드는 고유 ID, 시퀀스 번호 또는 ImapMessageInfoCollection 요소를 사용하여 서버에서 여러 메시지를 삭제하는 다양한 옵션을 제공합니다. 다음 코드 스니펫은 여러 메시지를 삭제하는 방법을 보여줍니다:

Python-Net: Aspose.Email을 사용한 Python에서 IMAP 이메일 검색 및 필터링

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

메일함의 모든 메시지를 가져오려면 Aspose.Email은 ’list_messages’ 메서드를 제공합니다 ImapClient 클래스. 특정 조건을 만족하는 메시지만 가져오려면, 해당 조건을 받아들이는 오버로드된 ’list_messages’ 메서드를 사용할 수 있습니다. MailQuery 을 인수로 사용합니다. MailQuery 클래스는 날짜, 제목, 발신자, 수신자와 같은 다양한 조건을 정의할 수 있는 여러 속성을 제공합니다.

첫 번째 코드 샘플은 날짜와 제목을 모두 기준으로 메시지를 필터링하는 방법을 보여줍니다. 추가 예제에서는 다른 기준으로 필터링하고 보다 복잡한 쿼리를 구성하는 방법을 소개합니다. 또한 API는 정확한 필터링을 위해 대소문자 구분 검색 기준을 지원하며, 메일함에서 메시지를 필터링할 때 검색 문자열의 인코딩을 지정할 수 있습니다.

IMAP 서버에서 메시지 필터링 및 가져오기

간단한 IMAP 쿼리 만들기

다음 코드 스니펫을 사용하여 IMAP 메일함에 연결하고 오늘 도착했으며 제목에 "newsletter" 단어가 포함된 메시지를 가져옵니다.

사용자 이름과 비밀번호를 사용해 포트 993으로 IMAP 서버에 연결합니다.
"Inbox" 폴더를 선택하여 수신 이메일을 작업합니다.
다음의 인스턴스를 생성합니다 ImapQueryBuilder 검색 쿼리를 구성합니다.
검색 기준을 지정합니다. 예를 들어, 이메일 제목에 "Newsletter"가 포함되고 내부 날짜가 오늘 날짜와 일치하도록 합니다.
빌더에서 검색 쿼리를 가져와 생성합니다.
쿼리를 사용하여 기준에 맞는 메시지를 나열합니다.
검색 기준과 일치하는 메시지 총수를 출력합니다.

복합 검색 기준 구축

Aspose.Email은 전송 날짜, 범위 내, 특정 발신자, 특정 도메인 또는 특정 수신자와 같은 이메일 메시지를 쿼리하고 필터링하기 위한 복합 검색 기준을 구축할 수 있게 합니다. 이를 위해 MailQueryBuilder 클래스와 그 속성들. 아래 코드 샘플은 특정 기준으로 메시지를 가져오는 방법을 보여줍니다.

오늘 날짜별 이메일 필터링

전송 날짜별로 메시지를 가져오려면, 해당 클래스의 ‘internal_date’ 속성을 사용하십시오 MailQueryBuilder 클래스는 아래 코드 샘플에 표시된 바와 같습니다:

import aspose.email as ae
from datetime import datetime

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

날짜 범위별 이메일 필터링

날짜 범위 내에서 메시지를 가져오려면 동일한 ‘internal_date’ 속성을 사용해 아래 코드 예시와 같이 날짜 범위를 지정하십시오:

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))

특정 발신자별 이메일 필터링

특정 발신자에서 메시지를 가져오려면, 해당 클래스의 ‘from_address’ 속성을 사용하십시오 MailQueryBuilder 클래스는 아래 코드 샘플에 표시된 바와 같습니다:

import aspose.email as ae

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

특정 도메인별 이메일 필터링

특정 도메인에서 메시지를 가져오려면 아래 코드 예시와 같이 ‘from_address’ 속성을 사용하십시오:

import aspose.email as ae

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

특정 수신자별 이메일 필터링

특정 수신인에게 메시지를 가져오려면 아래 코드 예시와 같이 ’to’ 속성을 사용하십시오:

import aspose.email as ae

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

내부 날짜별 메시지 필터링

"internal date" 및 "subject contains"와 같은 지정된 조건에 대한 쿼리를 구축합니다. "internal date"는 이메일이 수신되었거나 이메일 서버에 추가된 날짜와 시간을 의미하며, 해당 클래스의 ‘internal_date’ 속성을 사용하여 설정할 수 있습니다. ImapQueryBuilder 클래스. 아래 코드 샘플은 제목 및 날짜 기준에 따라 받은 편지함에서 특정 이메일을 가져오는 방법을 보여줍니다:

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}")

사용자 정의 키워드 플래그별 메시지 필터링

특정 사용자 정의 키워드 플래그인 "custom1" 및 "custom2"가 포함된 이메일을 검색하기 위한 IMAP 메일함 쿼리를 생성합니다. 쿼리를 구축하려면 다음을 사용하십시오 ImapQueryBuilder IMAP 서버에서 이메일을 검색할 때 필터링하는 클래스.

시작하려면 쿼리 빌더의 인스턴스를 생성하십시오. 다음을 사용하여 has_flags 메서드에 조건을 추가하여 지정된 IMAP 키워드 플래그를 포함하는 이메일만 포함하도록 합니다. IMAP의 사용자 정의 키워드(사용자 정의 플래그)는 사용자가 다양한 목적(예: 상태 표시)으로 이메일에 태그를 붙이거나 분류할 수 있게 합니다.

다음 코드 스니펫은 사용자 정의 키워드 플래그를 기반으로 이메일을 검색하는 쿼리를 만드는 방법을 보여줍니다:


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

복잡한 쿼리 구축

때때로 하나 이상의 쿼리를 만족해야 할 필요가 있습니다. Aspose.Email은 여러 문장에서 쿼리를 결합함으로써 이를 가능하게 합니다. 다음을 생성하십시오: MailQueryBuilder 객체와 그 속성을 사용해 특정 쿼리를 작성합니다.

AND로 쿼리 결합

다음 코드 스니펫은 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")

OR로 쿼리 결합

다음 코드 스니펫은 OR 연산자를 사용해 쿼리를 결합하는 방법을 보여줍니다.


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

대소문자 구분 필터 적용

API는 또한 대소문자를 구분하는 기준에 따라 사서함에서 이메일을 필터링할 수 있는 기능을 제공합니다. 다음 메서드들은 StringComparisonField 클래스는 대소문자 구분 플래그를 지정하여 이메일을 검색할 수 있는 기능을 제공합니다.

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

다음 코드 스니펫은 이 기능을 프로젝트에 구현하는 방법을 보여줍니다:


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

맞춤 검색 쿼리 수행

첨부 파일이 있는 이메일이라는 맞춤 Gmail 검색 기준에 따라 IMAP 메일함을 필터링하는 검색 쿼리를 생성합니다.

다음의 인스턴스를 생성하여 시작합니다 ImapQueryBuilder, 이는 복잡한 IMAP 검색 쿼리를 구축하는 데 도움이 됩니다. 다음을 사용하십시오 custom_search 쿼리 빌더에 Gmail 전용 검색 문자열을 추가하는 메서드.

검색 문자열 X-GM-RAW "has:attachment"은 Gmail 확장 IMAP 속성 X-GM-RAW를 활용하여 IMAP 쿼리 내에서 Gmail의 강력한 웹메일 검색 구문을 사용할 수 있게 합니다. 여기서 has:attachment 연산자는 첨부 파일이 포함된 모든 이메일을 반환합니다.

다음 코드 스니펫은 첨부 파일이 있는 모든 메시지를 가져오기 위해 이메일을 필터링하는 방법을 보여줍니다:


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

mailQuery = builder.get_query()

이 메서드는 고급 Gmail 전용 필터링을 통해 대상 이메일을 가져올 수 있게 합니다.

Python-Net: Python에서 IMAP 서버 확장 목록 조회

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

Aspose.Email ImapClient 메일 서버가 지원하는 IDLE, UNSELECT, QUOTA 등과 같은 서버 확장을 검색할 수 있게 합니다. 이를 통해 해당 기능에 의존하는 작업을 수행하기 전에 기능 사용 가능 여부를 확인할 수 있습니다. get_capabilities() 메서드 ImapClient 클래스는 지원되는 IMAP 확장 유형을 문자열 리스트로 반환합니다. 다음 코드 스니펫은 IMAP 확장 목록을 가져오는 방법을 보여줍니다:

Python-Net: Python에서 ImapClient 활동 로깅

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

활동 로깅 활성화

활동 로깅은 서버 연결, 전송 및 수신된 메시지 상세 정보, 이메일 처리 중 오류 메시지 및 클라이언트 또는 서버가 수행한 기타 모든 작업을 기록하는 것을 포함합니다. IMAP 클라이언트 활동 및 서버와의 상호 작용을 추적하려면, 다음 코드 샘플에서 ’log_file_name’ 속성을 사용하는 방법을 사용하십시오. ImapClient 지정된 로그 파일에 정보를 기록하는 클래스:

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: Python용 IMAP 클라이언트 유틸리티 기능

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

메일 서버 자격 증명 검증

추가 작업을 수행하기 전에 IMAP 서버에 보안 연결을 설정하기 위해 사용자 자격 증명을 확인하고 검증합니다. 해당 클래스의 ‘validate_credentials’ 메서드가 사용됩니다. ImapClient 클래스는 제공된 사용자 이름과 비밀번호가 올바른지 확인하는 데 도움을 줍니다. 자격 증명이 유효하면 클라이언트는 IMAP 서버에 성공적으로 인증할 수 있습니다. 다음 코드 샘플은 이 메서드를 프로젝트에 구현하는 방법을 보여줍니다:

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: Aspose.Email을 사용하여 Python에서 IMAP 폴더 관리

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

IMAP 폴더 목록

Aspose.Email을 사용하면 IMAP 서버에서 폴더 정보를 쉽게 가져올 수 있습니다. 아래 단계에 따라 폴더 세부 정보를 가져오고 작업하십시오:

Aspose.Email의 list_folders() 메서드를 사용하십시오. ImapClient 클래스. 이 메서드는 인스턴스를 반환합니다. ImapFolderInfoCollection, 모든 폴더에 대한 세부 정보를 포함합니다.
반복합니다 ImapFolderInfoCollection 개별 폴더의 정보를 접근하는 객체.
하위 폴더를 검색합니다(선택 사항). list_folders() 메서드는 오버로드되어 있으며, 폴더 이름을 매개변수로 전달하면 해당 폴더의 하위 폴더 컬렉션을 가져올 수 있습니다.

다음 코드 스니펫은 Aspose.Email 메서드를 사용해 IMAP 서버에서 폴더 정보를 가져오는 방법을 보여줍니다:

폴더 이름 변경 및 삭제

Aspose.Email은 다음 클래스의 메서드를 제공합니다. ImapClient IMAP을 통해 이메일 서버의 폴더를 관리하는 클래스:

delete_folder 메서드 - 폴더와 그 안에 포함된 모든 메시지를 영구적으로 삭제합니다.
rename_folder 메서드 - 폴더의 내용을 변경하지 않고 이름만 바꿉니다.

다음 코드 스니펫은 IMAP 서버에서 폴더를 프로그래밍 방식으로 삭제하거나 이름을 바꾸는 방법을 보여줍니다:

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

특정 폴더에 메시지 생성 및 추가

Aspose.Email API를 사용하면 다음을 이용할 수 있습니다. MailMessage 및 ImapClient 폴더에 새 메시지를 추가하기 위한 클래스들. 먼저, 다음을 생성합니다. MailMessage 객체에 제목, 발신자 및 수신자를 지정합니다. 이후 폴더를 구독하고 메시지를 추가합니다. 아래 코드 스니펫은 폴더에 새 메시지를 추가하는 방법을 보여줍니다:

다음으로 IMAP 클라이언트를 초기화합니다. ImapClient 이메일 서버에 연결하기 위한 클래스. 서버 주소, 포트, 사용자명 및 비밀번호를 제공합니다.
select_folder 메서드를 사용해 새 메시지를 추가할 대상 폴더(예: "Inbox")를 선택합니다.
다음으로 새 이메일을 생성합니다. MailMessage 클래스. 발신자, 수신자, 제목 및 메시지 내용을 지정합니다.
subscribe_folder 메서드와 폴더 이름을 사용해 폴더를 구독합니다.
append_message 메서드를 사용하여 새로 만든 메시지를 선택한 폴더에 추가하고, 폴더 이름과 메시지 객체를 지정합니다.

폴더 간 메시지 이동

Aspose.Email for .NET은 다음을 사용해 메시지를 한 메일함 폴더에서 다른 폴더로 이동할 수 있습니다. ImapClient API. move_message 메서드는 메시지 고유 ID와 대상 폴더 이름을 사용해 메시지를 이동합니다. 다음 코드 스니펫은 폴더 간에 메시지를 이동하는 방법을 보여줍니다:

폴더 간 메시지 복사

Aspose.Email API를 사용하면 메일함 폴더 간에 메시지를 손쉽게 복사할 수 있습니다. copy_message 및 copy_messages 메서드를 사용해 단일 메시지 또는 여러 메시지를 복사할 수 있습니다. copy_messages 메서드는 소스 폴더의 여러 메시지를 메일함 내 대상 폴더로 전송합니다. 아래 코드는 폴더 간 메시지 복사 방법을 보여줍니다:

특수용도 메일함 폴더 작업

특수용도 메일함은 Sent, Drafts, Junk, Trash, Archive와 같이 특정 종류의 메시지를 처리하도록 설계된 이메일 시스템의 사전 정의 폴더입니다. Aspose.Email 라이브러리는 이러한 메일함에 역할 및 목적에 맞는 속성을 연결하여 접근을 간소화합니다. 이를 통해 클라이언트는 사용자 개입 없이도 이러한 폴더를 자동으로 발견하고 표시할 수 있습니다.

다음 코드는 주요 특수용도 메일함(받은편지함, 임시 보관함, 스팸, 보낸 편지함, 휴지통)의 정보를 해당 속성을 사용해 가져오는 방법을 보여줍니다: ImapMailBoxInfo 클래스와 세부 정보를 출력합니다:

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)

폴더에 접근하고 메시지를 재귀적으로 읽기

ImapClient 재귀 메서드를 사용해 IMAP 서버에서 폴더와 하위 폴더를 나열합니다. 이 메서드는 또한 메시지를 MSG 형식으로 로컬 디스크에 읽고 저장하는 데 사용됩니다. 폴더와 메시지는 IMAP 서버에 나타나는 동일한 계층 구조로 생성 및 저장됩니다. 아래 코드는 폴더와 메시지를 재귀적으로 검색하는 방법을 보여줍니다:

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.")

배치 폴더 작업에 MultiConnection 사용

Aspose.Email을 사용하면 클라이언트를 구성해 IMAP 서버에 다중 동시 연결을 설정할 수 있습니다. 이는 반드시 성능을 향상시키지는 않지만, 동시 작업에 신뢰할 수 있는 솔루션입니다. 클라이언트가 여러 이메일 폴더를 가져오거나, 대량 데이터를 동기화하거나, 여러 메시지를 동시에 처리해야 할 때 특히 유용합니다.

다음 코드 스니펫은 ‘append_messages’ 메서드를 사용해 이메일 컬렉션을 업로드하면서 IMAP 서버에 다중 연결을 설정하는 방법을 보여줍니다. ImapClient 클래스:

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: Aspose.Email을 사용한 Python에서 IMAP 메시지 플래그 관리

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

Aspose.Email for Python via .NET를 사용하면 Python 애플리케이션에서 직접 Read, Answered, Deleted 및 사용자 정의 키워드와 같은 IMAP 메시지 플래그를 관리할 수 있습니다. 이러한 플래그는 메일함 내 이메일 메시지의 상태나 상황을 표시하는 데 도움이 되며, 조직적인 이메일 워크플로우를 구축하는 데 유용합니다.

이 문서에서는 다음 내용에 대해 설명합니다:

표준 IMAP 시스템 플래그 설정 및 제거
메시지에 사용자 정의 키워드 플래그 할당

키 메서드 사용됨:

change_message_flags()
remove_message_flags()
add_message_flags()

지원되는 플래그:

Answered
Deleted
Draft
Flagged
IsRead
Recent
사용자 정의 키워드 플래그

IMAP 메시지 플래그 설정

다음 사용 change_message_flags() 메서드 ImapClient 표준 플래그인 IsRead 또는 Deleted를 메시지에 적용하는 클래스입니다. 이 메서드는 메시지 식별자(시퀀스 번호 또는 UID)와 하나 이상 플래그를 매개변수로 받습니다.

다음 코드 스니펫은 Aspose.Email을 사용하여 IMAP 서버에서 메시지 플래그를 설정하는 방법을 보여줍니다:

메시지 플래그 제거

시스템 또는 사용자 정의 플래그를 다음을 사용하여 제거할 수 있습니다 remove_message_flags() 메서드 ImapClient 클래스. 이는 일반적으로 메시지의 읽음 또는 삭제 표시를 해제하는 데 사용됩니다. 아래 코드 샘플은 한 줄의 코드로 ‘is_read’ 플래그를 제거하는 방법을 보여줍니다:

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

IMAP 메시지에 사용자 정의 키워드 플래그 추가

Aspose.Email은 또한 다음을 사용하여 사용자 정의 키워드 플래그 할당을 지원합니다 add_message_flags() 메서드 ImapClient 클래스. 이러한 사용자 정의 플래그는 분류 또는 처리 규칙에 도움이 될 수 있습니다.

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: 파이썬에서 IMAP 서버로부터 이메일을 가져오고 나열하기

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

메일함에서 메시지 목록

’list_messages’ 메서드 ImapClient 클래스는 현재 선택된 폴더(이 경우 "Inbox")에서 모든 메시지 목록을 가져옵니다. 이 목록은 메시지 ID, 시퀀스 번호, UID 및 경우에 따라 제목이나 발신자 정보와 같은 요약 데이터를 포함하는 메시지 메타데이터 객체를 포함합니다.

아래 코드 스니펫은 받은편지함에서 메시지 메타데이터를 가져와 전체 메시지 수를 출력하는 방법을 보여줍니다:

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)}")

페이지 지원을 통한 메시지 목록

메일함에 대량의 메시지가 있는 경우, 페이지 지원을 통해 메시지를 나열하거나 검색하는 것이 일반적입니다. Aspose.Email은 ImapClient 클래스는 페이지 지원을 통해 서버에서 메시지를 검색할 수 있게 합니다.

재귀적으로 메시지 나열

IMAP 프로토콜은 메일함 폴더의 메시지를 재귀적으로 나열할 수 있게 하며, 하위 폴더의 메시지까지 나열이 가능합니다. 아래 코드 스니펫은 메시지를 재귀적으로 나열하는 방법을 보여줍니다:

MIME Message ID 목록

다음은 ImapMessageInfo 클래스는 전체 메시지 내용을 추출하지 않고도 메시지를 식별하기 위해 MIME MessageId에 접근하는 편리한 방법을 제공합니다. 아래 코드는 MIME MessageId를 나열하는 예시입니다:

다중 연결을 통한 메시지 목록

다음은 ImapClient 클래스는 use_multi_connection 속성을 제공하여 고부하 작업에 다중 연결을 사용할 수 있게 합니다. 또한 connections_quantity 속성을 사용해 다중 연결 모드에서 연결 수를 지정할 수 있습니다. 아래 코드 스니펫은 메시지 목록을 위해 다중 연결 모드를 활용하는 방법을 보여줍니다:

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)

이 모드를 사용한다고 반드시 성능이 향상되는 것은 아니라는 점에 유의하십시오.

시퀀스 번호 또는 고유 ID로 메시지 검색

Aspose.Email API를 사용하면 시퀀스 번호 목록과 받은편지함의 모든 메시지 고유 ID 목록 두 개를 생성할 수 있습니다. 식별자를 통해 IMAP 서버에서 메시지를 가져오려면 해당 클래스의 fetch_messages 메서드를 사용하십시오 ImapClient 클래스. 아래 코드 스니펫은 식별자를 사용해 메시지를 나열하는 방법을 보여줍니다:

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))

내림차순으로 메시지 가져오기

이 작업은 메시지 검색을 위한 페이지 설정을 정의함으로써 달성됩니다. 이를 위해 해당 클래스의 ascending_sorting 속성을 사용하십시오 PageSettings IMAP 클라이언트 모듈의 일부인 클래스입니다. ascending_sorting 속성을 설정하십시오 PageSettings 객체를 False로 설정합니다. 이는 기본적으로 메시지를 내림차순으로 정렬하여 가져옴을 의미합니다. 아래 코드 스니펫은 내림차순으로 메시지를 가져오는 방법을 보여줍니다:

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)

서버에서 메시지를 가져와 디스크에 저장

다음은 ImapClient 클래스는 IMAP 서버에서 메시지를 가져와 EML 형식으로 로컬 디스크에 저장할 수 있습니다. 메시지를 디스크에 저장하려면 다음 단계가 필요합니다:

다음 사용 ImapClient IMAP 서버에 연결하기 위해 필요한 매개변수(호스트, 포트, 사용자 이름, 비밀번호)를 가진 클래스.
select_folder 메서드(예: "Inbox")를 호출하여 원하는 폴더를 선택합니다
list_messages 메서드를 사용해 메시지를 순회하면서 가져옵니다.
메시지를 저장하려면 각 메시지에 대해 디렉터리를 지정하고 고유 ID를 파일 이름에 추가하는 save_message 메서드를 사용하십시오.

다음 코드 스니펫은 서버에서 이메일 메시지를 가져와 저장하는 방법을 보여줍니다:

MSG 형식으로 메시지 저장

MSG 형식으로 이메일을 저장하려면 해당 클래스의 fetch_message 메서드를 호출하십시오. ImapClient 클래스. 해당 클래스는 메시지를 다음 인스턴스로 반환합니다 MailMessage 클래스. MailMessage.save() 메서드를 호출하면 메시지를 MSG 형식으로 저장할 수 있습니다. 아래 코드 스니펫은 MSG 형식으로 메시지를 저장하는 방법을 보여줍니다.

추가 메시지 파라미터(요약 정보) 가져오기

아래 코드 스니펫은 Aspose.Email을 사용해 이메일 서버와 상호 작용하는 방법을 보여줍니다 ImapClient 이메일 메시지를 전송하고 조작하기 위해 사용됩니다. 코드는 메시지 UID를 사용해 추가 파라미터("X-GM-MSGID", "X-GM-THRID")와 함께 요약 정보를 가져옵니다. 시퀀스 번호를 사용해 유사한 정보를 가져올 수도 있습니다.

List-Unsubscribe 헤더 가져오기

"ListUnsubscribe" 헤더는 메일링 리스트 또는 자동 이메일 시스템에서 발송된 이메일 메시지 헤더에 일반적으로 포함됩니다. 이는 수신자가 메일링 리스트 또는 자동 이메일 구독을 해지할 수 있는 링크 또는 이메일 주소를 제공합니다. Aspose.Email은 ’list_unsubscribe’ 속성을 제공합니다. ImapMessageInfo 이 헤더를 검색하는 클래스. 아래 코드 스니펫은 해당 속성의 사용 방법을 보여주며, 원치 않는 이메일의 구독 해지를 자동화하는 시스템의 일부로 사용할 수 있습니다:

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)

메시지 식별 정보 가져오기

이메일 메시지를 검색하고 처리할 때, 시퀀스 번호를 사용해 메시지 상세 정보를 가져올 수 있습니다.

다음 기능을 사용해 IMAP 메일함과 상호 작용합니다:

Aspose.Email.ImapMessageInfo 클래스 - 메일함 내 메시지에 대한 식별 정보를 나타냅니다.
Aspose.Email.ImapMessageInfo.sequence_number 속성 - 메시지의 시퀀스 번호.
Aspose.Email.ImapMessageInfo.unique_id 속성 - 메시지의 고유 ID.

아래 코드 스니펫은 메시지 식별 정보를 얻는 방법을 보여줍니다:

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)

IMAP 이메일 메시지의 첨부 파일 목록

첨부 파일 데이터를 가져오지 않고 이름, 크기와 같은 정보를 얻으려면 다음 라이브러리 리소스를 사용하십시오:

ImapAttachmentInfo 클래스 - 첨부 정보(크기, 이름, 미디어 타입)를 나타냅니다.
ImapAttachmentInfoCollection 클래스 - 컬렉션을 나타냅니다 ImapAttachmentInfo.
list_attachments(sequence_number) 메서드 ImapClient 클래스 - 메시지의 첨부 정보 컬렉션을 반환합니다.

아래 코드 샘플은 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: Python API를 사용하여 IMAP 확장 활성화

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

IMAP 확장 지원

Aspose.Email API는 다양한 IMAP 프로토콜 확장을 지원합니다. 이러한 확장은 클라이언트 애플리케이션 식별 및 상세한 메일함 메타데이터 검색과 같은 고급 작업을 가능하게 합니다. 모든 이메일 서버가 이러한 기능을 지원하는 것은 아니지만, Gmail과 같은 많은 인기 서비스는 지원합니다.

이 문서는 다음 IMAP 확장들을 사용하는 방법을 보여줍니다. ImapClient Aspose.Email의 클래스:

IMAP ID 명령
IMAP LIST-EXTENDED 명령

IMAP ID 명령 사용

이 명령은 서버가 IMAP ID 확장을 지원하는지 여부를 알려주고, 서버로부터 구조화된 식별 세부 정보를 반환합니다. 이는 로깅, 진단 및 서버 동작 맞춤화에 유용합니다.

다음 코드 샘플은 Aspose.Email 라이브러리를 사용하여 IMAP 서버와 상호 작용하고, 특히 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)

IMAP LIST-EXTENDED 명령 사용

IMAP LIST-EXTENDED 명령(RFC 5258에 정의됨)은 클라이언트가 폴더 계층 구조 및 메타데이터(예: 폴더에 하위 폴더가 있는지 여부)를 상세히 가져올 수 있게 합니다. 이는 복잡한 메일함 구조를 관리하는 클라이언트에 특히 유용합니다.

다음 코드 샘플은 확장 LIST 명령을 사용하여 Gmail에서 폴더 목록을 표시하고 어떤 폴더에 하위 폴더가 포함되어 있는지 확인하는 방법을 보여줍니다:

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: Python에서 IMAP 메시지 백업 및 복원

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

Aspose.Email for Python은 다음 클래스의 메서드를 제공합니다. ImapClient IMAP 프로토콜을 통해 이메일 메시지를 관리하는 클래스:

‘backup’ 메서드
‘restore’ 메서드

이 문서는 다음을 사용하는 방법을 보여줍니다. ImapClient 클래스와 그 메서드를 사용해 PST 파일에 이메일 메시지를 백업 및 복원합니다. 또한 멀티-커넥션 모드를 이용해 대용량 메일함의 성능을 향상시키는 방법도 다룹니다.

IMAP 메시지 백업

IMAP 서버에서 이메일 메시지를 백업하려면 다음을 사용하십시오. backup 메서드 ImapClient 클래스. 다음 코드 샘플은 받은편지함 폴더를 .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)

IMAP 메시지 복원

.pst 파일에서 IMAP 서버로 메시지를 복원하려면 다음을 사용하십시오. restore 메서드 ImapClient 클래스:

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)

멀티-커넥션 모드로 성능 향상

대량 데이터 또는 많은 이메일 메시지를 다루는 작업을 위해 Aspose.Email은 해당 클래스의 ‘use_multi_connection’ 속성을 제공합니다. ImapClient 클래스는 클라이언트가 이메일 서버에 동시에 다중 연결을 열어 작업 성능을 최적화하도록 합니다. 언제 MultiConnectionMode 활성화되면 IMAP 클라이언트는 다양한 작업(예: 이메일 가져오기, 폴더 동기화, 데이터 백업)을 여러 연결에서 병렬로 수행할 수 있습니다. 이는 전체 작업 시간을 크게 단축시킬 수 있습니다. 다음 코드 스니펫은 활성화 방법을 보여줍니다. MultiConnection 백업 및 복원 작업을 위한 모드.

참고: 다중 연결 사용은 이메일 서버가 설정한 제한 및 정책의 적용을 받을 수 있습니다. 일부 서버는 서버 과부하를 방지하기 위해 단일 사용자 계정에서 동시에 연결할 수 있는 수를 제한할 수 있습니다. MultiConnectionMode를 활성화하기 전에 항상 이메일 제공자의 서비스 약관이나 정책을 확인하여 사용 지침을 준수하십시오.

MultiConnection 활성화된 상태에서 메시지 백업

다음 코드 스니펫은 MultiConnection 모드를 사용해 백업 작업을 수행하는 방법을 보여줍니다:

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)

멀티 연결을 사용한 메시지 복원

다음 코드 스니펫은 MultiConnection 모드를 사용해 복원 작업을 수행하는 방법을 보여줍니다.

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)