Documentation – کار با مشتری IMAP

Python-Net: اتصال به سرورهای IMAP در پایتون با استفاده از Aspose.Email

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

Aspose.Email برای پایتون از طریق .NET شامل ImapClient کلاس، که به توسعه‌دهندگان امکان اتصال به سرورهای ایمیل با استفاده از IMAP (پروتکل دسترسی به پیام اینترنتی) را می‌دهد. این کلاس مدیریت امن و کارآمد ایمیل‌ها را در برنامه‌های پایتون فراهم می‌کند، شامل دریافت، خواندن, جابه‌جایی, حذف و به‌روزرسانی پیام‌های ایمیل.

با استفاده از کلاینت IMAP می‌توانید کاربران را احراز هویت کنید، پوشه‌های صندوق پستی را مدیریت کنید، از طریق SSL متصل شوید، زمان‌سوت‌های سفارشی تنظیم کنید و به حساب‌های ایمیل از طریق سرورهای پروکسی یا احراز هویت CRAM‑MD5 دسترسی پیدا کنید.

اتصال پایه IMAP

برای اتصال به سرور IMAP با استفاده از Aspose.Email، این سه گام ساده را دنبال کنید:

یک نمونه از ImapClient کلاس.
نام میزبان، پورت، نام کاربری و رمز عبور را تعیین کنید.
گزینه امنیتی مطلوب را مشخص کنید.

نمونه کد زیر نشان می‌دهد چگونه به‌صورت برنامه‌نویسی به سرور IMAP متصل شوید:

import aspose.email as ae

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

فعال‌سازی SSL برای اتصالات IMAP

برای اتصال به سرور IMAP با پشتیبانی از SSL، مقدار 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 همچنین امکان اتصال IMAP از طریق پروکسی 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")

دسترسی فقط‑خواندنی به صندوق پستی

برای جلوگیری از تغییر محتویات صندوق پستی، حالت فقط‑خواندنی را فعال کنید. ویژگی 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 استفاده کند:

نمونه کد زیر نشان می‌دهد چگونه کلاینت را طوری پیکربندی کنید که CRAM-MD5 را به‌عنوان یکی از روش‌های احراز هویت پشتیبانی‌شده برای اتصال به سرور 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

تنظیم زمان‌سوت عملیات

از انتظار نامحدود کلاینت جلوگیری کنید با تنظیم زمان‌سوت (به میلیثانیه):

قطعه کد زیر نشان می‌دهد چگونه یک بازه زمان‌سوت 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 کلاس محدود کنید 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)

استفاده از TLS با کلاینت IMAP

Aspose.Email از TLS و SSL برای ارتباط امن پشتیبانی می‌کند. از supported_encryption ویژگی برای تعیین نسخه‌های پروتکل قابل قبول.

توجه: شما می‌توانید فقط نسخه‌های پروتکل را تنظیم کنید که توسط .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: حذف ایمیل‌ها از سرور IMAP در محیط پایتون

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

حذف تک پیام از سرور

برای حذف یک پیام از سرور IMAP، کتابخانه Aspose.Email متد delete_message را فراهم می‌کند ImapClient کلاسی. این کلاس شماره ترتیب پیام یا شناسهٔ یکتا را به‌عنوان پارامتر می‌گیرد. قطعه کد زیر نشان می‌دهد چگونه پیام ایمیلی با شناسهٔ پیام 1 را از سرور IMAP حذف کنید:

حذف چندین پیام از سرور

چندین ایمیل می‌توانند با استفاده از متد delete_messages از یک صندوق پستی حذف شوند ImapClient کلاسی ارائه‌شده توسط API Aspose.Email. این متد گزینه‌های متعددی برای حذف چندین پیام از سرور با استفاده از شناسه‌های یکتا، شماره‌های ترتیب یا عناصر ImapMessageInfoCollection فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه چندین پیام را حذف کنید:

Python-Net: جستجو و فیلتر ایمیل‌های IMAP در پایتون با استفاده از Aspose.Email

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

برای بازیابی تمام پیام‌ها از یک صندوق ایمیل، Aspose.Email متد ’list_messages’ را فراهم می‌کند ImapClient کلاس. برای دریافت تنها پیام‌هایی که شرایط خاصی را برآورده می‌کنند، می‌توانید از متد بیش‌بارگذاری‌شده ’list_messages’ که یک MailQuery به‌عنوان آرگومان. این MailQuery کلاس ویژگی‌های مختلفی برای تعریف این شرایط ارائه می‌دهد، مانند تاریخ، موضوع، فرستنده و گیرنده.

نمونه کد اول نشان می‌دهد چگونه پیام‌ها را بر اساس تاریخ و موضوع هر دو فیلتر کنید. مثال‌های اضافی فیلتر بر اساس معیارهای دیگر و ساخت پرس‌و‌جوهای پیچیده‌تر را نمایش می‌دهند. علاوه بر این، API معیارهای جستجوی حساس به حروف بزرگ/کوچک را برای فیلتر دقیق پشتیبانی می‌کند و به شما اجازه می‌دهد هنگام فیلتر پیام‌ها از صندوق، انکودینگ رشته جستجو را مشخص کنید.

فیلتر و دریافت پیام‌ها از سرور IMAP

ساخت یک پرس‌و‌جوی ساده IMAP

از قطعه کد زیر برای اتصال به یک صندوق ایمیل IMAP و دریافت پیام‌هایی که امروز رسیده‌اند و کلمهٔ "newsletter" در موضوع دارند استفاده کنید.

به سرور 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’ تنظیم کرد. 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}")

فیلتر پیام‌ها بر اساس پرچم‌های کلیدواژه سفارشی

یک پرس‌و‌جو برای جستجوی یک صندوق ایمیل IMAP ایجاد کنید که ایمیل‌های حاوی پرچم‌های کلیدواژه سفارشی، به‌خصوص "custom1" و "custom2" را پیدا کند. برای ساخت پرس‌و‌جو، از 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)

انجام پرس‌و‌جوهای سفارشی جستجو

یک پرس‌و‌جوی جستجو برای یک صندوق ایمیل IMAP ایجاد کنید که ایمیل‌ها را بر اساس معیار جستجوی سفارشی Gmail فیلتر می‌کند — به‌طور خاص، ایمیل‌هایی که پیوست دارند.

با ایجاد یک نمونه از ImapQueryBuilder، که به ساخت پرس‌و‌جوهای پیچیده IMAP کمک می‌کند. از custom_search متدی برای اضافه کردن رشتهٔ جستجوی مخصوص Gmail به سازندهٔ پرس‌و‌جو.

رشتهٔ جستجوی X-GM-RAW "has:attachment" از ویژگی گسترش یافتهٔ IMAP در Gmail به نام X-GM-RAW استفاده می‌کند و امکان به‌کارگیری سینتکس قدرتمند جستجوی وب‌میل Gmail را در پرس‌و‌جوهای IMAP فراهم می‌سازد. در اینجا، عملگر has:attachment تمام ایمیل‌های دارای پیوست را برمی‌گرداند.

قطعه کد زیر نشان می‌دهد چگونه ایمیل‌ها را فیلتر کنید تا تمام پیام‌های دارای پیوست را دریافت کنید:


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

mailQuery = builder.get_query()

این متد امکان فیلتر پیشرفته مخصوص Gmail را برای دریافت ایمیل‌های هدفمند فراهم می‌کند.

Python-Net: ثبت فعالیت 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: فهرست‌کردن افزونه‌های سرور IMAP در پایتون

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

Aspose.Email ImapClient به شما امکان می‌دهد افزونه‌های پشتیبانی‌شده توسط سرور ایمیل مانند IDLE، UNSELECT، QUOTA و غیره را بازیابی کنید. این کمک می‌کند تا اطمینان حاصل شود ویژگی‌های خاص قبل از انجام عملیاتی که به آن‌ها وابسته‌اند، در دسترس هستند. get_capabilities() متد از ImapClient کلاس فهرستی از انواع افزونه‌های پشتیبانی‌شده IMAP به‌صورت رشته‌ها برمی‌گرداند. قطعه کد زیر نشان می‌دهد چگونه فهرست افزونه‌های IMAP را بازیابی کنید:

Python-Net: ویژگی‌های کمکی برای کلاینت 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: مدیریت پوشه‌های IMAP در پایتون با Aspose.Email

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

فهرست پوشه‌های IMAP

دریافت اطلاعات پوشه از یک سرور IMAP با Aspose.Email ساده است. مراحل زیر را برای دریافت و کار با جزئیات پوشه دنبال کنید:

از متد list_folders() از Aspose.Email استفاده کنید ImapClient کلاس. این متد یک نمونه از ImapFolderInfoCollection, که شامل جزئیات تمام پوشه‌ها است.
در حلقه بگردید در ImapFolderInfoCollection شیئی برای دسترسی به اطلاعات دربارهٔ پوشه‌های منفرد.
دریافت زیرپوشه‌ها (اختیاری). متد list_folders() بیش‌بارگذاری شده است. می‌توانید نام یک پوشه را به‌عنوان پارامتر پاس کنید تا مجموعه‌ای از زیرپوشه‌های پوشه مشخص شده را دریافت کنید.

قطعه کد زیر نشان می‌دهد چگونه می‌توان اطلاعات پوشه را از یک سرور IMAP با استفاده از متد Aspose.Email بازیابی کرد:

تغییر نام و حذف پوشه‌ها

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

ایجاد و افزودن پیام‌ها به پوشه‌های مخصوص

با API Aspose.Email می‌توانید از MailMessage و ImapClient کلاس‌هایی برای افزودن پیام جدید به پوشه. ابتدا یک MailMessage شیء با تعیین موضوع، فرستنده و گیرنده. سپس به یک پوشه مشترک شوید و پیام را به آن اضافه کنید. قطعه کد زیر نشان می‌دهد چگونه یک پیام جدید به یک پوشه اضافه شود:

کلاینت IMAP را با استفاده از ImapClient کلاسی برای اتصال به سرور ایمیل شما. آدرس سرور، پورت، نام کاربری و رمز عبور را ارائه دهید.
پوشه هدفی که می‌خواهید پیام جدید را به آن اضافه کنید، مانند "Inbox"، را با استفاده از متد select_folder انتخاب کنید.
یک ایمیل جدید ایجاد کنید با استفاده از MailMessage کلاس. فرستنده، گیرنده، موضوع و محتوای پیام را مشخص کنید.
با استفاده از متد subscribe_folder و نام پوشه، مشترک پوشه شوید.
پیام تازه ایجاد شده را با استفاده از متد append_message به پوشه انتخاب‌شده اضافه کنید، با تعیین نام پوشه و شیء پیام.

انتقال پیام‌ها بین پوشه‌ها

Aspose.Email برای .NET امکان جابجایی پیام‌ها از یک پوشه صندوق‌پست به پوشه دیگری را با استفاده از ImapClient API. متد move_message از شناسه منحصر به‌فرد پیام و نام پوشه مقصد برای جابجایی پیام به پوشه مقصد استفاده می‌کند. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را بین پوشه‌ها جابجا کنید:

کپی پیام‌ها بین پوشه‌ها

API Aspose.Email به شما امکان می‌دهد پیام‌ها را به‌سادگی از یک پوشه صندوق‌پست به پوشه دیگری کپی کنید. می‌توانید یک پیام یا چند پیام را با استفاده از متدهای copy_message و copy_messages کپی کنید. متد copy_messages امکان انتقال چندین پیام از یک پوشه منبع به پوشه مقصد درون صندوق‌پست را می‌دهد. در زیر قطعه کد برای کپی کردن پیام‌ها بین پوشه‌ها آورده شده است:

کار با پوشه‌های صندوق‌پست خاص استفاده

صندوق‌پست‌های خاص استفاده، پوشه‌های پیش‌تعریف‌شده‌ای در سیستم ایمیل هستند که برای مدیریت انواع خاص پیام‌ها مانند Sent، Drafts، Junk، Trash و Archive طراحی شده‌اند. کتابخانه Aspose.Email دسترسی به این صندوق‌پست‌ها را با ارتباط ویژگی‌ها با نقش و منظور آن‌ها ساده می‌کند. این به کلاینت‌ها اجازه می‌دهد تا به‌صورت خودکار این پوشه‌ها را کشف و نمایش دهند بدون نیاز به مداخله کاربر.

قطعه کد زیر نشان می‌دهد چگونه می‌توان اطلاعات دربارهٔ صندوق‌پست‌های خاص استفاده (Inbox, Drafts, Junk, Sent, و Trash) را با استفاده از ویژگی‌های 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 فراهم می‌کند. این لزوماً عملکرد را افزایش نمی‌دهد، اما راه‌حل قابل اعتمادی برای عملیات همزمان است. این به‌ویژه مفید است اگر کلاینت نیاز به انجام چندین کار به‌همزمان داشته باشد، مانند دریافت پوشه‌های ایمیل مختلف، همگام‌سازی داده‌های بزرگ، یا پردازش چندین پیام به‌طور همزمان.

قطعه کد زیر نشان می‌دهد چگونه چندین اتصال به سرور IMAP برقرار شود در حین بارگذاری مجموعه‌ای از پیام‌های ایمیل با استفاده از متد ‘append_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)

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

Python-Net: مدیریت پرچم‌های پیام IMAP در پایتون با Aspose.Email

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

Aspose.Email برای پایتون از طریق .NET به شما امکان می‌دهد پرچم‌های پیام IMAP مانند Read، Answered، Deleted و کلیدواژه‌های سفارشی را مستقیماً از برنامه پایتون خود مدیریت کنید. این پرچم‌ها برای علامت‌گذاری وضعیت یا حالت پیام‌های ایمیل در صندوق پستی مفید هستند و برای ساخت گردش کار منظم ایمیل کاربرد دارند.

این مقاله توضیح می‌دهد چگونه:

تنظیم و حذف پرچم‌های استاندارد سیستم IMAP
اختصاص پرچم‌های کلیدواژه سفارشی به پیام‌ها

کلید متدها استفاده‌شده:

change_message_flags()
remove_message_flags()
add_message_flags()

پرچم‌های پشتیبانی‌شده:

پاسخ‌داده‌شده
حذف‌شده
پیشنویس
پرچم‌دار
IsRead
جدید
پرچم‌های کلیدواژه سفارشی

تنظیم پرچم‌های پیام IMAP

از change_message_flags() متد از ImapClient کلاسی برای اعمال پرچم‌های استاندارد مانند IsRead یا Deleted به پیام‌ها. این متد یک شناسهٔ پیام (شمارهٔ ترتیب یا UID) و یک یا چند پرچم را به‌عنوان ورودی می‌گیرد.

قطعه کد زیر نشان می‌دهد چگونه پرچم‌های پیام را بر روی سرور IMAP با Aspose.Email تنظیم کنید:

حذف پرچم‌های پیام

می‌توانید با استفاده از 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") دریافت می‌کند. این فهرست شامل اشیای متادیتای پیام است که معمولاً شامل شناسه‌های پیام، شماره‌های توالی، 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

این 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)

لطفاً توجه داشته باشید که استفاده از این حالت لزوماً به افزایش عملکرد منجر نمی‌شود.

دریافت پیام‌ها بر اساس شماره توالی یا شناسه یکتا

API Aspose.Email به شما امکان می‌دهد دو فهرست پیام تولید کنید، یکی شامل شماره‌های توالی و دیگری شامل شناسه‌های یکتای تمام پیام‌های صندوق ورودی. برای دریافت پیام‌ها از سرور 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 کلاس با پارامترهای لازم (host, port, username, password) برای اتصال به سرور IMAP.
پوشه موردنظر را با فراخوانی متد select_folder (مثلاً "Inbox") انتخاب کنید
پیام‌ها را با تکرار بر روی آن‌ها با استفاده از متد list_messages بازیابی کنید.
برای ذخیره پیام‌ها، برای هر پیام از متد 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 ویژگی - شناسهٔ یکتا یک پیام.

قطعه کد زیر نشان می‌دهد چگونه اطلاعات شناسایی پیام‌ها را به‌دست آورید:

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: فعال‌سازی افزونه‌های IMAP با استفاده از API پایتون

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

پشتیبانی از افزونه‌های IMAP

API Aspose.Email پشتیبانی از مجموعه‌ای از افزونه‌های پروتکل IMAP را فراهم می‌کند. این افزونه‌ها عملیات پیشرفته‌ای مانند شناسایی برنامه‌های کلاینت و بازیابی متادیتای دقیق صندوق‌پست را امکان‌پذیر می‌سازند. اگرچه تمام سرورهای ایمیل این امکانات را ندارند، بسیاری از سرویس‌های محبوب مانند جیمیل این ویژگی‌ها را پشتیبانی می‌کنند.

این مقاله نشان می‌دهد که چگونه از افزونه‌های 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 توسعه‌یافته فهرست کرد و بررسی کرد کدام پوشه‌ها زیرپوشه دارند:

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: پشتیبان‌گیری و بازیابی پیام‌های IMAP در پایتون

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

Aspose.Email برای پایتون روش‌های ImapClient کلاسی برای مدیریت پیام‌های ایمیل از طریق پروتکل IMAP:

متد ‘backup’
متد ‘restore’

این مقاله نشان می‌دهد چگونه از ImapClient کلاس و متدهای آن برای پشتیبان‌گیری و بازیابی پیام‌های ایمیل به‌ و از یک فایل PST. همچنین نحوه بهبود عملکرد برای صندوق‌پست‌های بزرگ با استفاده از حالت چنداتصال را پوشش می‌دهد.

پشتیبان‌گیری پیام‌های IMAP

برای ایجاد پشتیبان از پیام‌های ایمیل از یک سرور IMAP، از backup متد از ImapClient کلاس. نمونه کد زیر نشان می‌دهد چگونه پوشه Inbox را به یک فایل .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)

تقویت عملکرد با حالت Multi-Connection

برای کارهایی که شامل مقدار زیادی داده یا پیام‌های ایمیل متعدد هستند، 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

قطعه کد زیر نشان می‌دهد چگونه یک عملیات بازیابی را با فعال‌سازی حالت 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)