Documentation – עבודה עם לקוח POP3

Python-Net: התחברות לשרת POP3 בפייתון

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

התחבר לשרת POP3 באמצעות אימות בסיסי

Aspose.Email for Python API מספקת את Pop3Client מחלקה, המאפשרת ליישומים לנהל תיבות דואר דרך פרוטוקול הדואר הידוע בשם Post Office Protocol גרסה 3 (POP3). השתמש במחלקה זו כדי לקבוע חיבור עם שרת POP3. היא משמשת כממשק הראשי למפתחים המעוניינים לשלב ניהול POP3 ביישומי .NET שלהם. מאמר זה מספק מדריך לשימוש יעיל במחלקת Pop3Client.

קטע הקוד הבא מציג כיצד לקבוע חיבור לשרת אימייל POP3 באמצעות Aspose.Email Pop3Client מחלקה. היא ממחישה את תהליך הקונפיגורציה של החיבור עם פרמטרים חיוניים כגון כתובת השרת, פרטי המשתמש, הגדרות האבטחה ומספר הפורט. הגדרה זו נדרשת לקבלת אימיילים בצורה מאובטחת מחשבון Gmail.

צור מופע של Pop3Client.
ציין את המארח, שם המשתמש, הסיסמה, הפורט ואפשרויות האבטחה.

התחבר לשרת POP3 עם SSL מופעל

כדי להתחבר לשרת POP3 עם SSL מופעל, השתמש ב‑Aspose.Email Pop3Client מחלקה והגדר את אפשרויות האבטחה ופרופרטיז הפורט. קטע הקוד הבא מראה כיצד להתחבר לשרת POP3 עם SSL מופעל:

התחבר לשרת POP3 עם אימות APOP

APOP (Authenticated Post Office Protocol) הוא שיטה מאובטחת לקבלת אימיילים משרת הדואר. הוא משפר את פרוטוקול POP3 המסורתי על‑ידי הוספת שכבת אימות המגנה על פרטי המשתמש.

במקום לשלוח את שם המשתמש והסיסמה בטקסט גלוי, APOP משתמש בערך מגובה במהלך תהליך האימות. בעת ההתחברות, הלקוח יוצר גיבוב בעזרת מפתח סודי (הסיסמה של המשתמש) וערך אתגר (מחרוזת ייחודית שנוצרה על ידי השרת).

התחבר לשרת POP3 דרך פרוקסי

שרתי פרוקסי משמשים כמתווכים בין לקוח האימייל שלך לשרת הדואר בעת תקשורת עם העולם החיצון. במקום להתחבר ישירות

Aspose.Email מספקת תמיכה בשימוש בשרתי פרוקסי, במיוחד גרסאות 4, 4a ו‑5 של פרוטוקול 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 (מנגנון אימות Challenge‑Response עם MD5) משמש בדרך כלל בפרוטוקולי אימייל כגון POP3 ו‑IMAP, שבהם האימות המאובטח חשוב. הוא מספק רמת אבטחה גבוהה יותר מאשר העברת סיסמא בטקסט גלוי. Aspose.Email for .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 בפייתון

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

Aspose.Email for .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 מספקת Pop3Client מחלקה המאפשרת לאחזר את התוספות הנתמכות של שרת POP3, כגון IDLE, UNSELECT, QUOTA ועוד. ידיעת התוספות הזמינות היא קריטית לקביעת אם ניתן להשתמש בפונקציונליות ספציפית. ה‑ get_capabilities() השיטה מחזירה את סוגי התוספות הנתמכות כמערך מחרוזות.

דוגמת הקוד הבאה מציגה כיצד לאחזר תוספות שרת באמצעות Pop3Client עבור שרת Gmail:

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

רישום פעילות מאפשר לך לנטר ולתעד פעולות שמבצע לקוח ה‑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 מאפשר למפתחים לעבוד עם הודעות דוא"ל במגוון דרכים. לדוגמה, הם יכולים לאחזר מידע כותרת לפני קבלת החלטה האם להוריד הודעת דוא"ל. או שהם יכולים לאחזר הודעות משרת ולשמור אותן ללא ניתוח (מהיר יותר) או לאחר ניתוח (איטי יותר). מאמר זה מציג כיצד לאחזר ולהמיר הודעות דוא"ל.

קבלת מידע על כותרות דוא"ל

כותרות אימייל יכולות לספק לנו מידע על הודעת אימייל שנוכל להשתמש בו כדי решить אם לאחזר את כל ההודעה. בדרך כלל, מידע בכותרת כולל שולח, נושא, תאריך קבלה וכו’ (כותרות האימייל מתוארות בפירוט ב‑Customizing Email Headers. נושא זה מתמקד בשליחת אימייל עם SMTP, אך מידע כותרת האימייל נשאר רלוונטי לאימיילים ב‑POP3). הדוגמאות הבאות מראות כיצד לאחזר כותרות אימייל משרת POP3 באמצעות מספר הסדרה של ההודעה.

קבלת הודעות דוא"ל

רכיב המחלקה Aspose.Email.Pop3 מספק את היכולת לאחזר הודעות אימייל משרת POP3 ולנתח אותן ל‑instance של MailMessage בעזרת רכיבי MailMessage. מחלקת MailMessage מכילה מספר מאפיינים ומתודות למניפולציית תוכן האימייל. באמצעות פונקציית FetchMessage של המחלקה Pop3Client, ניתן לקבל instance של MailMessage ישירות משרת POP3. קטע הקוד הבא מראה כיצד לאחזר הודעת אימייל מלאה משרת POP3.

שילוף מידע מסכם של הודעה באמצעות מזהה ייחודי

לקוח ה‑POP3 של ה‑API יכול לאחזר מידע סיכום של הודעה מהשרת באמצעות המזהה הייחודי של ההודעה. זה מספק גישה מהירה למידע הקצר של ההודעה בלי תחילה לאחזר את ההודעה המלאה מהשרת. קטע הקוד הבא מראה כיצד לאחזר מידע סיכום של הודעה.

רישום הודעות עם חיבור מרובה

לפעולות בעלות עומס גבוה, Aspose.Email מציע את המאפיין ‘use_multi_connection’ של Pop3Client מחלקה לשימוש בריבוי חיבורים בעת שליפת אימיילים. עם זאת, שימוש במצב זה אינו מחייב שהביצועים ישתפרו. קטע הקוד הבא מראה כיצד להקים חיבור לשרת POP3, להגדיר את הלקוח לאפשר עד 5 חיבורים מקבילים ולהפעיל מצב ריבוי חיבורים כדי לאחזר מידע על ההודעות הקיימות בשרת:

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. קטע הקוד הבא מראה כיצד לשמור הודעה לפי מספר הסדרה שלה, במקרה זה מספר 1. מתודת SaveMessage שומרת את ההודעה בפורמט EML המקורי ללא ניתוח.

פירוש הודעה לפני שמירה

השתמש במתודה ‘fetch_message’ של אובייקט ה‑client שנוצר באמצעות 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, המתוארת במדריך Connecting to a POP3 Server, מספקת את המתודה 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 מחלקה מספקת את היכולת לחפש אימיילים עם דגלים רגישים לאותיות גדולות/קטנות.

מתודה 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 בפייתון

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 ולהמירן ל‑instances של MailMessage. זה מתאפשר דרך המאפיינים והמתודות של MailMessage מחלקה, שמקלה על מניפולציית תוכן האימייל. באמצעות fetch_message שיטה של Pop3Client מחלקה, אתה יכול לקבל MailMessage מופע ישירות משרת POP3. קטע הקוד הבא מדגים כיצד לאחזר הודעת אימייל שלמה מהשרת:

אחזור סיכום הודעה לפי מזהה ייחודי

לקוח ה‑POP3 של ה‑API מאפשר לך לאחזר מידע סיכום על הודעות מהשרת באמצעות המזהים הייחודיים שלהם. תכונה זו מספקת גישה מהירה לפרטים החיוניים של הודעה ללא צורך להוריד את כל התוכן תחילה. קטע הקוד הבא מדגים כיצד לגשת למידע הסיכום של הודעה באמצעות Aspose.Email Python API:

רשימת הודעות באמצעות חיבורים מרובים

לפעולות בעלות עומס גבוה, Aspose.Email מציע את use_multi_connection מאפיין של Pop3Client מחלקה לשימוש בריבוי חיבורים בעת שליפת אימיילים. חשוב לציין שהפעלת מוד זה לא תמיד מבטיחה שיפור בביצועים. קטע הקוד הבא מראה כיצד להקים חיבור לשרת POP3, להגדיר את הלקוח לאפשר עד 5 חיבורים מקבילים ולהפעיל מצב ריבוי חיבורים כדי לאחזר מידע על ההודעות המאוחסנות בשרת:

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 בפייתון

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

שמור אימיילים לדיסק ללא ניתוח

להורדת הודעות אימייל משרת POP3 ללא ניתוח, ניתן להשתמש ב‑ save_message מתודה של Aspose.Email Pop3Client מחלקה. קטע הקוד הבא מדגים כיצד לשמור הודעה באמצעות מספר הסדרה שלה, במקרה זה מספר 1. ה‑ save_message מתודה משמרת את פורמט ה‑EML המקורי ללא ניתוח:

פרש הודעות לפני שמירה

ניתן לאחזר הודעת אימייל ספציפית באמצעות fetch_message שיטה של Pop3Client מחלקה, שמציינת את מספר הסדרה הרצוי לאובייקט ה‑client. קוד הדוגמה הבא מראה כיצד לאחזר הודעה מסוימת ולאחר מכן לשמור אותה תוך שימוש בנושא שלה כשם הקובץ על ידי קריאה ל‑ 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 class מספקת את list_messages() מתודה אשר מקבלת את כל ההודעות מתיבת דואר. כדי לקבל רק הודעות שתואמות תנאי מסוים, השתמש ב- list_messages(query) מתודה אשר מקבלת MailQuery כארגומנט. ה- MailQuery המחלקה מספקת מגוון מאפיינים לציון תנאי השאילתה, כגון תאריך, נושא, שלוח, מקבל וכד'.

לבניית ביטוי החיפוש, השתמש ב‑ MailQueryBuilder מחלקה. ראשית, הגדר את כל התנאים והמגבלות הנדרשים, ולאחר מכן מלא את אובייקט MailQuery עם השאילתה שנוצרה על ידי MailQueryBuilder. Pop3Client משתמש באובייקט MailQuery זה כדי לאחזר מידע מסונן מהשרת.

דוגמת הקוד הבאה מציגה כיצד לסנן ולאחזר אימיילים מחשבון Gmail על בסיס קריטריונים שונים כולל נושא, תאריך פנימי, שולח ומקבל. היא גם מציגה סינון רגיש לאותיות גדולות/קטנות ומדגימה כיצד לבנות שאילתות מורכבות ביעילות.

הקם חיבור לשרת Gmail 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"))

החל סינונים רגישים לאותיות גדולות/קטנות

קטע הקוד הבא מראה כיצד ליישם אפשרות זו בפרויקט שלך:

import aspose.email as ae

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