Documentation – کار با کلاینت POP3

Python-Net: اتصال به سرور POP3 با Python

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

اتصال به سرور POP3 با استفاده از احراز هویت پایه

API Aspose.Email برای Python ارائه می‌دهد Pop3Client کلاس، که به برنامه‌ها امکان مدیریت صندوق‌های ایمیل از طریق پروتکل پست‌دفتری نسخه 3 (POP3) را می‌دهد. از این کلاس برای برقراری اتصال با سرور POP3 استفاده کنید. این کلاس به‌عنوان رابط اصلی برای توسعه‌دهندگانی که می‌خواهند مدیریت POP3 را در برنامه‌های .NET خود ادغام کنند، عمل می‌کند. این مقاله راهنمایی‌های لازم برای استفاده مؤثر از کلاس Pop3Client را ارائه می‌دهد.

قطعه کد زیر نشان می‌دهد چگونه با استفاده از Aspose.Email یک اتصال به سرور ایمیل POP3 برقرار کنید Pop3Client کلاس. این کلاس فرآیند پیکربندی اتصال با پارامترهای اساسی مانند آدرس سرور، اعتبارهای کاربر، تنظیمات امنیتی و شماره پورت را نشان می‌دهد. این تنظیمات برای دریافت ایمیل‌ها به‌صورت امن از حساب Gmail ضروری است.

یک نمونه از Pop3Client.
آدرس هاست، نام کاربری، رمز عبور، پورت و گزینه‌های امنیتی را مشخص کنید.

اتصال به سرور POP3 با SSL فعال

برای اتصال به سرور POP3 با SSL، از Aspose.Email استفاده کنید Pop3Client کلاس و تنظیم گزینه‌های امنیتی و خصوصیات پورت. قطعه کد زیر نشان می‌دهد چگونه به سرور POP3 فعال‌سازی SSL متصل شوید:

اتصال به سرور POP3 با احراز هویت APOP

APOP (پروتکل پست‌دفتری احراز هویت‌شده) روشی امن برای دریافت ایمیل‌ها از سرور ایمیل است. این روش با افزودن لایه‌ای از احراز هویت به پروتکل سنتی POP3، اطلاعات کاربری را محافظت می‌کند.

به‌جای ارسال نام کاربری و رمز عبور به‌صورت متن ساده، APOP در فرآیند احراز هویت از مقدار هش‌شده استفاده می‌کند. هنگام ورود، کلاینت با استفاده از کلید مخفی (رمز عبور کاربر) و مقدار چالش (رشته یکتا تولید شده توسط سرور) یک هش ایجاد می‌کند.

اتصال به سرور POP3 از طریق پروکسی

سرورهای پروکسی به‌عنوان واسطه بین کلاینت ایمیل شما و سرور ایمیل هنگام ارتباط با دنیای بیرون عمل می‌کنند. به‌جای اتصال مستقیم به سرور ایمیل، درخواست‌های ایمیل شما از طریق یک پروکسی عبور می‌کند، که مزایای متعددی از جمله مخفی‌سازی آدرس IP شما و دسترسی به محتوای محدود را فراهم می‌کند. استفاده از سرورهای پروکسی می‌تواند حریم خصوصی و امنیت را به‌ویژه هنگام دسترسی به ایمیل در شبکه‌های عمومی، افزایش دهد.

Aspose.Email پشتیبانی از استفاده از سرورهای پروکسی، به‌ویژه نسخه‌های ۴، ۴a و ۵ پروتکل پروکسی SOCKS را فراهم می‌کند. این قابلیت به توسعه‌دهندگان امکان می‌دهد برنامه‌هایی بسازند که بتوانند به‌صورت مؤثر از طریق پروکسی‌ها با سرورهای ایمیل ارتباط برقرار کنند. ویژگی آن Pop3Client کلاس امکان دسترسی و دستکاری پیام‌ها را با استفاده از پروتکل پست‌دفتری نسخه 3 (POP3) برای برنامه‌ها فراهم می‌کند. یکی از متدهای مفید getmailboxinfo()، که اطلاعات ضروری درباره صندوق‌پست مانند تعداد پیام‌ها و اندازه کل را بازیابی می‌کند، و مدیریت حساب‌های ایمیل را ساده می‌سازد.

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

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
# Set proxy address, Port and Proxy
proxy_address = "192.168.203.142"
proxy_port = 1080
proxy = ae.clients.SocksProxy(proxy_address, proxy_port, ae.clients.SocksVersion.SOCKS_V5)
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

پشتیبانی از پروکسی HTTP

انواع مختلفی از پروکسی‌ها وجود دارند، از جمله پروکسی‌های HTTP، SOCKS و غیره که هرکدام اهداف متفاوتی دارند و سطوح مختلفی از عملکرد را ارائه می‌دهند. مراحل و پیکربندی‌های خاص ممکن است بسته به نوع پروکسی متفاوت باشد. نمونه کد زیر نشان می‌دهد چگونه تنظیمات Pop3Client با پیکربندی اضافی یک پروکسی HTTP و دریافت اطلاعات درباره صندوق‌پست:

import aspose.email as ae

proxy = ae.clients.HttpProxy("18.222.124.59", 8080)
client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

اتصال به سرور با احراز هویت CRAM-MD5

CRAM-MD5 (مکانیزم احراز هویت چالش-پاسخ با MD5) معمولاً در پروتکل‌های ایمیل مانند POP3 و IMAP که احراز هویت امن مهم است، استفاده می‌شود. این روش سطح امنیتی بالاتری نسبت به انتقال رمز عبور به‌صورت متن ساده فراهم می‌کند. Aspose.Email برای .NET به کاربران امکان می‌دهد به‌صورت امن احراز هویت کنند و به سرورهای ایمیلی که این روش احراز هویت را پشتیبانی می‌کنند، دسترسی داشته باشند.

client.allowed_authentication = ae.clients.pop3.Pop3KnownAuthenticationType.CRAM_MD5

پیکربندی زمان‌انتظار عملیات ایمیل

Aspose.Email ویژگی ’timeout’ را برای Pop3Client کلاس برای دریافت یا تنظیم زمان‌انتظار عملیات ایمیل به‌منظور جلوگیری از گیر کردن یا مسدود شدن، مدیریت مسائل شبکه یا سرور، افزایش واکنش‌پذیری و تضمین مدیریت بهینه منابع. نمونه کد زیر نشان می‌دهد چگونه این ویژگی را در یک پروژه پیاده‌سازی کنید:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
#  60 seconds
client.timeout = 60000

استفاده از پروتکل‌های کریپتوگرافی با کلاینت POP3

Aspose.Email از پروتکل‌های کریپتوگرافی SSL (منقضی) و TLS برای تأمین امنیت ارتباط پشتیبانی می‌کند. می‌توانید رمزنگاری کریپتوگرافی را فعال کنید تا مبادله داده‌ها بین برنامه شما و سرورهای ایمیل محافظت شود.

NOTE: It's important to know that you can only configure protocol versions supported by the .NET Framework. If your current .NET Framework version does not support certain protocol versions, those unsupported versions will be disregarded and skipped. This could result in a potential downgrade in TLS security level, and it's crucial to be aware that no exceptions will be raised in this situation. Developers should exercise caution to ensure the desired TLS security level is maintained based on the supported protocols in their .NET Framework environment.

نمونه کد زیر نشان می‌دهد چگونه یک کلاینت POP3 را با پیکربندی‌های پروتکل رمزنگاری TLS 1.3 برای ارتباط امن راه‌اندازی کنید:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS13

در صورتی که یک پروتکل رمزنگاری مشخص در نسخه جاری .NET Framework پشتیبانی نشود، تفاوت رفتار بین متد ‘SetSupportedEncryptionUnsafe’ و خصوصیت ‘SupportedEncryption’ به شرح زیر است:

اگر خصوصیت ‘SupportedEncryption’ استفاده شود، کلاینت ایمیل پروتکل رمزنگاری را به سطح پشتیبانی‌شده پایین می‌آورد.

اگر متد ‘SetSupportedEncryptionUnsafe’ استفاده شود، کلاینت ایمیل استثناها را پرتاب می‌کند.

Python-Net: حذف ایمیل‌ها از سرور POP3 با Python

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

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

این مقاله توضیح می‌دهد چگونه پیام‌ها را با استفاده از کلاینت POP3 Aspose.Email در سناریوهای مختلف حذف کنید.

حذف ایمیل بر اساس شاخص

قطعه کد زیر نشان می‌دهد چگونه تمام پیام‌های یک صندوق ایمیل را یکی‌یکی بر اساس شاخص آن‌ها حذف کنید. عدد شاخص هرگز نباید ≤0 باشد در متد Pop3Client.DeleteMessage.

حذف تمام ایمیل‌ها

همچنین می‌توان فراخوانی کرد delete_messages() متد برای حذف تمام پیام‌ها. قطعه کد زیر نشان می‌دهد چگونه از این متد استفاده کنید:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Delete all the messages
client.delete_messages()

اگر اتصال به سرور POP3 بلافاصله پس از عملیات حذف از دست برود، undelete_messages() متد دیگر قابل فراخوانی برای بازگرداندن داده‌ها نیست.

لغو عملیات حذف

متد undelete_messages می‌تواند برای لغو حذف پیام‌های ایمیل استفاده شود. قطعه کد زیر نشان می‌دهد چگونه از این متد استفاده کنید:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Cancel deletes
client.undelete_messages()

Python-Net: اعتبارسنجی اعتبارهای سرور POP3 در پایتون

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

Aspose.Email ارائه می‌دهد validate_credentials() متد از Pop3Client کلاسی برای تأیید اعتبارهای ورود کاربر (نام کاربری و رمز عبور) برای یک سرور ایمیل POP3. این متد اطمینان می‌دهد که اعتبارها معتبر هستند و امکان احراز هویت موفق و دسترسی به صندوق پستی با استفاده از پروتکل POP3 را می‌دهد. اگر اعتبارها نادرست باشند، متد ‘False’ برمی‌گرداند یا استثنایی پرتاب می‌کند که نشانگر شکست احراز هویت است.

قطعه کد زیر نحوه اعتبارسنجی اعتبارهای سرور POP3 با استفاده از API Aspose.Email را نشان می‌دهد:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: امکانات کمکی - کلاینت POP3

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

اعتبارسنجی اعتبارهای سرور ایمیل

Aspose.Email متد ‘validate_credentials()’ را فراهم می‌کند Pop3Client کلاسی برای تأیید اعتبارها (نام کاربری و رمز عبور) ارائه‌شده توسط کاربر برای دسترسی به سرور ایمیل POP3. این متد اطمینان می‌دهد که اعتبارهای ورود کاربر دقیق و معتبر هستند و به آن‌ها امکان احراز هویت موفق و دسترسی به حساب ایمیل خود را با استفاده از پروتکل POP3 می‌دهد. اگر اعتبارهای ارائه‌شده نادرست باشند، ممکن است متد خطایی برگرداند یا استثنایی پرتاب کند که نشان‌دهنده شکست فرآیند ورود است.

قطعه کد زیر روش تأیید ارائه‌شده توسط API را نشان می‌دهد:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: فهرست‌کردن افزونه‌های پشتیبانی‌شده سرور POP3

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

Aspose.Email یک Pop3Client کلاس که امکان بازیابی افزونه‌های پشتیبانی‌شده یک سرور POP3 مانند IDLE، UNSELECT، QUOTA و … را می‌دهد. دانستن اینکه کدام افزونه‌ها موجود هستند برای تعیین امکان استفاده از ویژگی‌های خاص بسیار مهم است. get_capabilities() متد انواع افزونه‌های پشتیبانی‌شده را به‌صورت آرایه‌ای از رشته‌ها برمی‌گرداند.

نمونه کد زیر نشان می‌دهد چگونه با استفاده از Pop3Client برای سرور Gmail افزونه‌های سرور را بازیابی کنید:

Python-Net: بازیابی ایمیل‌ها از سرور POP3 با Python

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

دریافت اطلاعات صندوق‌پست و تعداد پیام‌ها

API Aspose.Email به شما امکان انجام عملیات مختلفی روی پیام‌ها در سرور را می‌دهد، از جمله دریافت اطلاعات دربارهٔ صندوق‌پست مانند تعداد پیام‌ها و اندازهٔ صندوق‌پست با استفاده از get_mailbox_size() و get_mailbox_info() متدها.

این get_mailbox_size() متد اندازه صندوق‌پست را برحسب بایت برمی‌گرداند.
این get_mailbox_info() متد یک شیء از نوع را برمی‌گرداند Pop3MailBoxInfo.

همچنین می‌توان تعداد پیام‌ها را با استفاده از message_count ویژگی و اندازه را با استفاده از ویژگی `occupied_size`` به دست می‌آورید. کد نمونه زیر نشان می‌دهد چگونه اطلاعات مربوط به صندوق‌پست را دریافت کنید. این نشان می‌دهد چگونه:

ایجاد یک Pop3Client.
اتصال به سرور POP3.
دریافت اندازه صندوق‌پست.
دریافت اطلاعات صندوق‌پست.
دریافت تعداد پیام‌ها در صندوق‌پست.
دریافت اندازه اشغال شده.

فقط دریافت تعداد پیام‌ها

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

فقط دریافت سرآیندهای ایمیل

Aspose.Email به توسعه‌دهندگان امکان دسترسی به متادیتای ایمیل بدون دانلود محتوای کامل پیام را می‌دهد. در بسیاری از سناریوها، بررسی فقط سرآیندهای ایمیل—مانند فرستنده، موضوع و تاریخ دریافت—برای تعیین ارزش بازیابی یک پیام مفید است. این رویکرد بار سرور را کاهش داده و عملکرد را بهبود می‌بخشد، به‌ویژه هنگام کار با صندوق‌پست‌های بزرگ از طریق اتصال POP3.

نمونه کد زیر نشان می‌دهد چگونه به یک سرور POP3 وصل شوید و فقط سرآیندهای یک پیام خاص را با استفاده از شماره توالی آن دریافت کنید. این عملیات سبک به شما کمک می‌کند تصمیم‌های آگاهانه‌ای دربارهٔ اینکه کدام ایمیل‌ها را دانلود یا نادیده بگیرید، بگیرید.

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

Aspose.Email Pop3Client کلاس امکان دریافت پیام‌های ایمیل از یک سرور POP3 و تبدیل آن‌ها به نمونه‌های MailMessage را فراهم می‌کند. این قابلیت از طریق ویژگی‌ها و متدهای MailMessage کلاس، که دستکاری محتوای ایمیل را تسهیل می‌کند. با استفاده از fetch_message متد از Pop3Client کلاس، می‌توانید یک MailMessage نمونه‌ای مستقیماً از سرور POP3. قطعه کد زیر نشان می‌دهد چگونه یک پیام ایمیل کامل را از سرور بازیابی کنید:

دریافت خلاصه پیام با شناسهٔ یکتا

کلاینت POP3 API امکان دریافت اطلاعات خلاصه‌ای دربارهٔ پیام‌ها از سرور با استفاده از شناسه‌های یکتا را می‌دهد. این ویژگی دسترسی سریع به جزئیات ضروری پیام را بدون نیاز به دانلود کامل محتوا فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه با استفاده از Aspose.Email Python API به اطلاعات خلاصهٔ پیام دسترسی پیدا کنید:

لیست پیام‌ها با استفاده از چندین اتصال

برای عملیات با بار سنگین Aspose.Email ارائه می‌دهد use_multi_connection ویژگی Pop3Client کلاس برای استفاده از چندین اتصال هنگام دریافت ایمیل‌ها. مهم است که توجه داشته باشید فعال‌سازی این حالت همیشه تضمین کننده بهبود عملکرد نیست. قطعه کد زیر نشان می‌دهد چگونه به یک سرور POP3 متصل شوید، کلاینت را طوری پیکربندی کنید که تا ۵ اتصال همزمان را اجازه دهد و حالت چند‌اتصال را فعال کنید تا اطلاعات پیام‌های ذخیره‌شده در سرور را بازیابی کنید:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

Python-Net: بازیابی ایمیل‌ها از سرور POP3 با Python

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

ذخیره ایمیل‌ها بر روی دیسک بدون تجزیه

برای دانلود پیام‌های ایمیل از سرور POP3 بدون تجزیه، می‌توانید از save_message متد Aspose.Email Pop3Client کلاس. قطعه کد زیر نشان می‌دهد چگونه پیام را با استفاده از شماره توالی‌اش، در این مثال شماره ۱، ذخیره کنید. save_message متد قالب اصلی EML را بدون تجزیه حفظ می‌کند:

تجزیه پیام‌ها پیش از ذخیره‌سازی

می‌توانید یک پیام ایمیل خاص را با استفاده از fetch_message متد از Pop3Client کلاس، با مشخص کردن شماره توالی موردنظر برای شیء کلاینت. نمونه کد زیر نشان می‌دهد چگونه یک پیام خاص را دریافت و سپس با استفاده از موضوع آن به‌عنوان نام فایل ذخیره کنید، با فراخوانی save متد روی شیء msg:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

فیلتر ایمیل‌ها از سرور بر اساس معیارها

Aspose.Email Pop3Client کلاس فراهم می‌کند list_messages() متد تمام پیام‌های یک صندوق‌پست را دریافت می‌کند. برای دریافت تنها پیام‌هایی که با شرطی مطابقت دارند، از نسخهٔ بارگذاری‌شدهٔ list_messages(query) متدی که می‌گیرد MailQuery به‌عنوان آرگومان. این MailQuery کلاس ویژگی‌های مختلفی برای مشخص کردن شرایط پرس‌وجو فراهم می‌کند، مثلاً تاریخ، موضوع، فرستنده، گیرنده و غیره.

برای ساختن عبارت جستجو، از MailQueryBuilder کلاس. ابتدا تمام شرایط و محدودیت‌های لازم را تعریف کنید، سپس شیء MailQuery را با پرس‌وجویی که توسط MailQueryBuilder. کلاینت Pop3Client از این شیء MailQuery برای دریافت اطلاعات فیلترشده از سرور استفاده می‌کند.

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

اتصال به سرور POP3 جیمیل را با استفاده از Pop3Client کلاس با آدرس سرور، پورت، نام کاربری و رمز عبور مشخص شده. گزینه‌های امنیتی برای اتصال ایمن به AUTO تنظیم شده‌اند.
یک نمونه از MailQueryBuilder برای ساختن معیارهای جستجو برای فیلتر کردن ایمیل‌ها.
فیلتر بر اساس موضوع:
- ایمیل‌های حاوی "Newsletter" در خط موضوع به عنوان شرط فیلتر مشخص شده‌اند.
فیلتر بر اساس تاریخ داخلی:
- یک فیلتر برای ایمیل‌های دریافت‌شده در تاریخ جاری تنظیم شده است.
- یک فیلتر اضافی برای دریافت ایمیل‌های دریافت‌شده در هفتهٔ گذشته اضافه شده است.
فیلتر بر اساس فرستنده:
- فیلترها برای جستجوی ایمیل‌ها از آدرس ایمیل خاص (saqib.razzaq@127.0.0.1) و شامل کردن ایمیل‌ها از دامنهٔ خاصی (SpecificHost.com) اعمال می‌شوند.
فیلتر بر اساس گیرنده:
- یک فیلتر برای یافتن ایمیل‌های ارسال‌شده به گیرندهٔ خاصی مشخص شده است.
ترکیب پرس‌وجوها با استفاده از عملگر OR برای جستجوی ایمیل‌هایی که یا موضوع مشخصی دارند یا از آدرس خاصی ارسال شده‌اند.
فیلتر حساس به حروف:
- یک فیلتر حساس به حروف برای موضوع حاوی "Newsletter" مشخص شده است (با پارامتر True نشان داده شده).
لیست پیام‌ها:
- متد list_messages() با پرس‌وجوی ساخته‌شده فراخوانی می‌شود تا پیام‌های فیلترشده را از صندوق‌پست دریافت کند.
در نهایت، تعداد پیام‌های فیلترشده را چاپ کنید.

فیلتر ایمیل‌ها بر اساس تاریخ

برای دریافت پیام‌ها بر اساس تاریخ تحویل، از internal_date ویژگی همان‌طور که در نمونه کد زیر نشان داده شده است:

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 ویژگی همان‌طور که در نمونه کد زیر نشان داده شده است:

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

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

گاهی لازم است بیش از یک پرس‌و‌جو را برآورده کنید. 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 ترکیب کنید:

import aspose.email as ae

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

اعمال فیلترهای حساس به حروف

API همچنین امکان فیلتر کردن ایمیل‌ها از صندوق‌پست بر پایه معیار حساس به حروف را فراهم می‌کند. متدهای زیر از StringComparisonField کلاس امکان جستجوی ایمیل‌ها با پرچم‌های حساس به حروف را فراهم می‌کند:

متد Aspose.Email.StringComparisonField.contains(value, ignore_case) متد Aspose.Email.StringComparisonField.equals(value, ignore_case) متد Aspose.Email.StringComparisonField.not_contains(value, ignore_case) متد Aspose.Email.StringComparisonField.not_equals(value, ignore_case)

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

import aspose.email as ae

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

Python-Net: فعال‌سازی لاگ‌گیری فعالیت سرور POP3 در Python

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

لاگ‌گیری فعالیت به شما امکان مانیتورینگ و ضبط عملیات انجام‌شده توسط کلاینت Pop3 هنگام اتصال و تعامل با سرور POP3 را می‌دهد. فعال‌سازی این ویژگی به حل مشکلات کمک می‌کند، نظارت بر امنیت را بهبود می‌بخشد و از تطابق با سیاست‌های حفظ داده و حریم خصوصی پشتیبانی می‌کند.

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

یک نمونه از Pop3Client، و با مشخص کردن هاست، پورت، نام کاربری و رمز عبور همراه با گزینه‌های امنیتی.
مسیر فایل لاگ را با استفاده از تنظیم کنید log_file_name ویژگی.
در صورت نیاز، تنظیمات لاگ را با تنظیم use_date_in_log_file_name ویژگی در صورت لزوم.

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
# Set the path to the log file using the LogFileName property.
client.log_file_name = "C:\\Aspose.Email.Pop3.log"
# Set the UseDateInLogFileName property if it is necessary.
client.use_date_in_log_file_name = False

Python-Net: کار با پیام‌ها از سرور

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

دریافت اطلاعات صندوق‌پست

می‌توانیم اطلاعاتی دربارهٔ صندوق‌پست مانند تعداد پیام‌ها و اندازهٔ صندوق‌پست را با استفاده از متدهای GetMailBoxSize() و GetMailBoxInfo() به دست آوریم.

متد GetMailBoxSize() اندازهٔ صندوق‌پست را بر حسب بایت برمی‌گرداند.
متد GetMailBoxInfo() یک شیء از نوع Pop3MailBoxInfo را برمی‌گرداند.

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

ایجاد یک Pop3Client.
اتصال به سرور POP3.
دریافت اندازه صندوق‌پست.
دریافت اطلاعات صندوق‌پست.
دریافت تعداد پیام‌ها در صندوق‌پست.
دریافت اندازه اشغال شده.

دریافت تعداد ایمیل‌ها در صندوق‌پست

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

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

دریافت اطلاعات سرآیندهای ایمیل

سرآیندهای ایمیل می‌توانند اطلاعاتی دربارهٔ پیام ایمیل به ما بدهند که می‌توانیم برای تصمیم‌گیری دربارهٔ دریافت کل پیام ایمیل استفاده کنیم. معمولاً اطلاعات سرآیند شامل فرستنده، موضوع، تاریخ دریافت و غیره است (سرآیندهای ایمیل به‌تفصیل در سفارشی‌سازی سرآیندهای ایمیل توضیح داده شده‌اند. آن موضوع به‌طور خاص دربارهٔ ارسال ایمیل با SMTP است، اما اطلاعات محتوای سرآیند ایمیل برای ایمیل‌های POP3 نیز معتبر است). مثال‌های زیر نشان می‌دهند چگونه سرآیندهای ایمیل را از یک سرور POP3 بر اساس شماره توالی پیام دریافت کنیم.

دریافت پیام‌های ایمیل

کامپوننت کلاس Aspose.Email.Pop3 امکان دریافت پیام‌های ایمیل از سرور POP3 و تجزیه آن‌ها به یک نمونه MailMessage را با کمک اجزای MailMessage فراهم می‌کند. کلاس MailMessage حاوی چندین ویژگی و متد برای دستکاری محتوای ایمیل است. با استفاده از تابع FetchMessage در کلاس Pop3Client، می‌توانید یک نمونه MailMessage را مستقیماً از سرور POP3 دریافت کنید. قطعه کد زیر نشان می‌دهد چگونه یک پیام ایمیل کامل را از سرور POP3 بازیابی کنید.

بازیابی اطلاعات خلاصهٔ پیام با استفاده از شناسهٔ یکتا

کلاینت POP3 API می‌تواند اطلاعات خلاصهٔ پیام را از سرور با استفاده از شناسه یکتای پیام دریافت کند. این امکان دسترسی سریع به اطلاعات کوتاه پیام را بدون نیاز به بازیابی کامل پیام از سرور فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه اطلاعات خلاصهٔ پیام را دریافت کنید.

فهرست‌کردن پیام‌ها با چند‌اتصال

برای عملیات با بار سنگین Aspose.Email ویژگی ‘use_multi_connection’ را از Pop3Client کلاس برای استفاده از چندین اتصال هنگام دریافت ایمیل‌ها. با این حال، استفاده از این حالت لزوماً به بهبود عملکرد منجر نمی‌شود. قطعه کد زیر نشان می‌دهد چگونه به یک سرور POP3 متصل شوید، کلاینت را طوری تنظیم کنید که تا ۵ اتصال همزمان مجاز باشد و حالت چند‌اتصال را فعال کنید تا اطلاعات پیام‌های موجود در سرور را دریافت کنید:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

دریافت پیام‌ها از سرور و ذخیره‌سازی بر روی دیسک

ذخیره پیام بر روی دیسک بدون تجزیه

اگر می‌خواهید پیام‌های ایمیل را از سرور POP3 بدون تجزیه‌ و تحلیل دانلود کنید، از تابع SaveMessage در کلاس Pop3Client استفاده کنید. تابع SaveMessage پیام ایمیل را تجزیه نمی‌کند لذا سریع‌تر از تابع FetchMessage است. قطعه کد زیر نشان می‌دهد چگونه پیامی را بر اساس شماره توالی آن ذخیره کنید، در این مثال شماره ۱. متد SaveMessage پیام را در قالب اصلی EML بدون تجزیه ذخیره می‌کند.

تجزیه پیام قبل از ذخیره‌سازی

از متد ‘fetch_message’ شیء کلاینت ایجاد شده با استفاده از Pop3Client کلاسی برای دریافت پیام با شماره توالی خاص. نمونه کد زیر نشان می‌دهد چگونه یک پیام خاص را دریافت و با استفاده از موضوع آن به‌عنوان نام فایل ذخیره کنید، با فراخوانی متد ‘save’ در شیء msg:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

فیلتر کردن پیام‌ها بر اساس فرستنده، گیرنده یا تاریخ

کلاس Pop3Client که در بخش اتصال به سرور POP3 توصیف شده است، متد list_messages() را فراهم می‌کند که تمام پیام‌های یک صندوق‌پست را دریافت می‌کند. برای دریافت فقط پیام‌هایی که با شرطی مطابقت دارند، از متد ListMessages() بارگذاری‌شده استفاده کنید که یک MailQuery را به‌عنوان آرگومان می‌گیرد. کلاس MailQuery ویژگی‌های مختلفی برای مشخص کردن شرایط پرس‌وجو ارائه می‌دهد، مثلاً تاریخ، موضوع، فرستنده، گیرنده و غیره. کلاس MailQueryBuilder برای ساختن عبارت جستجو استفاده می‌شود. ابتدا تمام شرایط و محدودیت‌ها تنظیم می‌شوند و سپس MailQuery با پرس‌وجویی که توسط MailQueryBuilder توسعه یافته پر می‌شود. شیء کلاس MailQuery توسط Pop3Client برای استخراج اطلاعات فیلترشده از سرور استفاده می‌شود. این مقاله نشان می‌دهد چگونه پیام‌های ایمیل را از یک صندوق‌پست فیلتر کنیم. مثال اول نشان می‌دهد چگونه پیام‌ها را بر اساس تاریخ و موضوع فیلتر کنیم. همچنین نشان می‌دهیم چگونه بر مبنای معیارهای دیگر فیلتر کنیم و چگونه پرس‌وجوهای پیچیده‌تر بسازیم. همچنین کاربرد فیلتر تاریخ و زمان برای دریافت ایمیل‌های خاص از صندوق‌پست نشان داده می‌شود. علاوه بر این، نحوه اعمال فیلتر حساس به حروف کوچک و بزرگ نیز توضیح داده می‌شود.

فیلتر کردن پیام‌ها از صندوق‌پست

برای فیلتر کردن پیام‌ها از یک صندوق‌پست:

اتصال و ورود به یک سرور POP3.
یک نمونه از MailQuery ایجاد کنید و ویژگی‌های دلخواه را تنظیم کنید.
متد Pop3Client.list_messages(MailQuery query) را فراخوانی کنید و MailQuery را به‌عنوان پارامترها پاس دهید تا فقط پیام‌های فیلترشده دریافت شوند.

قطعه کد زیر نشان می‌دهد چگونه به یک صندوق‌پست POP3 متصل شوید و پیام‌هایی که امروز دریافت شده‌اند و در موضوع آن‌ها واژه "newsletter" وجود دارد، دریافت کنید.

دریافت پیام‌هایی که معیارهای خاص را برآورده می‌کنند

Aspose.Email همچنین امکان ساخت معیارهای جستجوی پیچیده برای پرس‌و‌جو و فیلتر کردن پیام‌های ایمیل را فراهم می‌کند. برای این منظور از MailQueryBuilder کلاس و ویژگی‌های آن. معیارهای دریافت به شرح زیر هستند:

دریافت پیام‌ها بر اساس تاریخ تحویل.
دریافت پیام‌ها در بازه‌ای.
دریافت پیام‌ها از فرستندهٔ خاص.
دریافت پیام‌ها از دامنهٔ خاص.
دریافت پیام‌ها برای گیرندهٔ خاص.

تاریخ امروز

برای دریافت پیام‌ها بر اساس تاریخ تحویل، از ویژگی ‘internal_date’ همان‌طور که در نمونه کد زیر نشان داده شده است استفاده کنید:

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’ همان‌طور که در نمونه کد زیر نشان داده شده است استفاده کنید:

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

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

گاهی لازم است بیش از یک پرس‌وجو را برآورده کنید. 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 ترکیب کنید.

import aspose.email as ae

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

اعمال فیلترهای حساس به حروف

API همچنین امکان فیلتر کردن ایمیل‌ها از صندوق‌پست بر پایه معیار حساس به حروف را فراهم می‌کند. متدهای زیر از StringComparisonField کلاسی که امکان جستجوی ایمیل‌ها با تعیین پرچم‌های حساس به حروف را فراهم می‌کند.

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

import aspose.email as ae

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