Documentation – การทำงานกับ IMAP Client

Python-Net: เชื่อมต่อกับเซิร์ฟเวอร์ IMAP ใน Python ด้วย Aspose.Email

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

Aspose.Email สำหรับ Python ผ่าน .NET มีส่วนรวมของ ImapClient คลาสที่อนุญาตให้นักพัฒนาเชื่อมต่อกับเซิร์ฟเวอร์เมลโดยใช้ IMAP (Internet Message Access Protocol) คลาสนี้ทำให้การจัดการอีเมลอย่างปลอดภัยและมีประสิทธิภาพในแอปพลิเคชัน Python รวมถึงการดึง, อ่าน, ย้าย, ลบและอัพเดตข้อความอีเมล

โดยใช้ไคลเอนต์ IMAP คุณสามารถยืนยันตัวผู้ใช้ จัดการโฟลเดอร์กล่องจดหมาย เชื่อมต่อผ่าน SSL ตั้งค่า timeout ที่กำหนดเอง และเข้าถึงบัญชีอีเมลผ่านเซิร์ฟเวอร์พร็อกซี่หรือการตรวจสอบสิทธิ์ 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 Proxy

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 Proxy

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

ตั้งค่า Operation Timeout

ป้องกันไม่ให้ไคลเอนต์รออย่างไม่สิ้นสุดโดยตั้งค่า timeout (เป็นมิลลิวินาที):

โค้ดสแน็ปต่อไปนี้แสดงวิธีตั้งระยะเวลา timeout เป็น 60,000 มิลลิวินาที (60 วินาที) ให้ไคลเอนต์รอการตอบสนองจากเซิร์ฟเวอร์:

import aspose.email as ae

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

ตั้งค่า Greeting Timeout

ควบคุมระยะเวลาที่ไคลเอนต์รอระหว่างการจับมือเริ่มต้นกับเซิร์ฟเวอร์เมล

โค้ดสแน็ปต่อไปนี้แสดงวิธีจำกัดเวลา greeting timeout โดยใช้คุณสมบัติ 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 ในสภาพแวดล้อม Python

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

ลบข้อความเดี่ยวจากเซิร์ฟเวอร์

เพื่อการลบข้อความจากเซิร์ฟเวอร์ IMAP ไลบรารี Aspose.Email มีเมธอด delete_message ของ ImapClient คลาส จะรับลำดับหมายเลขข้อความหรือ ID ที่ไม่ซ้ำเป็นพารามิเตอร์ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบอีเมลที่มี ID ข้อความ 1 จากเซิร์ฟเวอร์ IMAP:

ลบหลายข้อความจากเซิร์ฟเวอร์

เมลหลายฉบับสามารถลบจากกล่องเมลได้โดยใช้เมธอด delete_messages ของ ImapClient คลาสที่ให้โดย Aspose.Email API วิธีนี้ให้ตัวเลือกหลายอย่างในการลบหลายข้อความจากเซิร์ฟเวอร์โดยใช้ ID ไม่ซ้ำ ลำดับหมายเลขหรืออิลเมนต์ ImapMessageInfoCollection ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบหลายข้อความ:

Python-Net: ค้นหาและกรองอีเมล IMAP ใน Python ด้วย 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 โดยใช้พอร์ต 993 พร้อมกับชื่อผู้ใช้และรหัสผ่าน.
เลือกโฟลเดอร์ "Inbox" เพื่อทำงานกับอีเมลที่เข้ามา.
สร้างอินสแตนซ์ของ ImapQueryBuilder เพื่อสร้างคิวรีการค้นหา.
ระบุเกณฑ์การค้นหา ตัวอย่างเช่น หัวข้อของอีเมลควรมีคำว่า "Newsletter" และวันที่ภายในควรตรงกับวันที่วันนี้.
สร้างคิวรีการค้นหาโดยดึงจากตัวสร้าง.
ใช้คิวรีเพื่อแสดงรายการข้อความที่ตรงตามเกณฑ์.
พิมพ์จำนวนรวมของข้อความที่ตรงกับเกณฑ์การค้นหา.

สร้างเกณฑ์การค้นหาที่ซับซ้อน

Aspose.Email ยังทำให้สามารถสร้างเกณฑ์การค้นหาที่ซับซ้อนได้สำหรับการสืบค้นและกรองอีเมล เช่น วันที่จัดส่ง, อยู่ในช่วง, ผู้ส่งเฉพาะ, โดเมนเฉพาะ หรือผู้รับเฉพาะ เพื่อวัตถุประสงค์นี้ให้ใช้ MailQueryBuilder คลาสและคุณสมบัติของมัน โค้ดตัวอย่างด้านล่างจะแสดงวิธีดึงข้อความตามเกณฑ์เฉพาะ

กรองอีเมลตามวันที่ของวันนี้

เพื่อดึงข้อความตามวันที่จัดส่งให้ใช้คุณสมบัติ ‘internal_date’ ของ MailQueryBuilder คลาสตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae
from datetime import datetime

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

กรองอีเมลตามช่วงวันที่

เพื่อดึงข้อความในช่วงวันที่ ใช้คุณสมบัติ ‘internal_date’ เดียวกันและระบุช่วงวันที่ตามตัวอย่างโค้ดด้านล่าง:

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

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

กรองอีเมลตามผู้ส่งเฉพาะ

เพื่อดึงข้อความจากผู้ส่งเฉพาะ ใช้คุณสมบัติ ‘from_address’ ของ MailQueryBuilder คลาสตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

กรองอีเมลตามโดเมนเฉพาะ

เพื่อดึงข้อความจากโดเมนเฉพาะ ใช้คุณสมบัติ ‘from_address’ ตามตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

กรองอีเมลตามผู้รับเฉพาะ

เพื่อดึงข้อความไปยังผู้รับเฉพาะ ใช้คุณสมบัติ ’to’ ตามตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

กรองข้อความตามวันที่ภายใน

สร้างคิวรีตามเงื่อนไขที่ระบุเช่น "internal date" และ "subject contains" "internal date" หมายถึงวันที่และเวลาที่ข้อความอีเมลได้รับหรือถูกเพิ่มลงในเซิร์ฟเวอร์อีเมลและสามารถตั้งค่าโดยใช้คุณสมบัติ ‘internal_date’ ของ ImapQueryBuilder คลาส ตัวอย่างโค้ดด้านล่างแสดงวิธีดึงอีเมลเฉพาะจากกล่องขาเข้าโดยอิงตามหัวเรื่องและเกณฑ์วันที่:

import aspose.email as ae
from datetime import datetime

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

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

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

กรองข้อความตามธงคีย์เวิร์ดกำหนดเอง

สร้างคิวรีเพื่อค้นหากล่องเมล 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 ใน Python

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 ใน Python

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 ใน Python

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

Aspose.Email ImapClient ทำให้คุณสามารถดึงส่วนขยายของเซิร์ฟเวอร์ที่อีเมลเซิร์ฟเวอร์รองรับ เช่น IDLE, UNSELECT, QUOTA และอื่น ๆ ซึ่งช่วยรับประกันว่าฟีเจอร์เฉพาะพร้อมใช้ก่อนดำเนินการที่พึ่งพา. The get_capabilities() เมธอดของ ImapClient คลาสคืนค่ารายการประเภทส่วนขยาย IMAP ที่รองรับในรูปแบบสตริง ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการดึงรายการส่วนขยาย IMAP:

Python-Net: จัดการโฟลเดอร์ IMAP ใน Python ด้วย 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")

สร้างและเพิ่มข้อความไปยังโฟลเดอร์เฉพาะ

ด้วย Aspose.Email API คุณสามารถใช้ MailMessage และ ImapClient คลาสเพื่อเพิ่มข้อความใหม่ลงในโฟลเดอร์ ก่อนอื่นสร้าง a MailMessage อ็อบเจกต์โดยระบุหัวเรื่อง, ผู้ส่ง และผู้รับ จากนั้นสมัครสมาชิกโฟลเดอร์และเพิ่มข้อความลงในนั้น ตัวอย่างโค้ดด้านล่างแสดงวิธีเพิ่มข้อความใหม่ลงในโฟลเดอร์:

เริ่มต้นไคลเอนต์ IMAP ด้วย ImapClient คลาสเพื่อเชื่อมต่อกับเซิร์ฟเวอร์อีเมลของคุณ ระบุที่อยู่เซิร์ฟเวอร์, พอร์ต, ชื่อผู้ใช้, และรหัสผ่าน
เลือกโฟลเดอร์เป้าหมายที่คุณต้องการเพิ่มข้อความใหม่ เช่น "Inbox" โดยใช้วิธี select_folder
สร้างอีเมลใหม่โดยใช้ MailMessage คลาส ระบุผู้ส่ง, ผู้รับ, เรื่อง, และเนื้อหาข้อความ.
สมัครสมาชิกโฟลเดอร์โดยใช้วิธี subscribe_folder พร้อมชื่อโฟลเดอร์
เพิ่มข้อความที่สร้างใหม่ลงในโฟลเดอร์ที่เลือกโดยใช้วิธี append_message ระบุชื่อโฟลเดอร์และอ็อบเจกต์ของข้อความ

การย้ายข้อความระหว่างโฟลเดอร์

Aspose.Email สำหรับ .NET อนุญาตให้ย้ายข้อความจากโฟลเดอร์กล่องจดหมายหนึ่งไปยังอีกโฟลเดอร์โดยใช้ ImapClient API วิธี move_message ใช้ id ที่ไม่ซ้ำของข้อความและชื่อโฟลเดอร์ปลายทางเพื่อย้ายข้อความไปยังโฟลเดอร์ปลายทาง ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการย้ายข้อความระหว่างโฟลเดอร์:

คัดลอกข้อความระหว่างโฟลเดอร์

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 ใน Python ด้วย Aspose.Email

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

Aspose.Email สำหรับ Python ผ่าน .NET อนุญาตให้คุณจัดการธงข้อความ IMAP เช่น Read, Answered, Deleted และคีย์เวิร์ดกำหนดเองโดยตรงจากแอปพลิเคชัน Python ของคุณ ธงเหล่านี้ช่วยระบุสถานะหรือสภาพของข้อความอีเมลในกล่องเมลและมีประโยชน์ในการสร้าง workflow อีเมลที่เป็นระบบ.

บทความนี้ครอบคลุมวิธีการ:

ตั้งค่าและลบธงระบบ IMAP มาตรฐาน
กำหนดธงคีย์เวิร์ดกำหนดเองให้กับข้อความ

คีย์ เมธอด ใช้:

change_message_flags()
remove_message_flags()
add_message_flags()

ธงที่รองรับ:

Answered
Deleted
Draft
Flagged
IsRead
Recent
ธงคีย์เวิร์ดกำหนดเอง

ตั้งค่าธงข้อความ 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 ด้วย Python

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

แสดงรายการข้อความจากกล่องจดหมาย

เมธอด ’list_messages’ ของ ImapClient คลาสดึงรายการของข้อความทั้งหมดจากโฟลเดอร์ที่เลือกในขณะนี้ (ในกรณีนี้คือ "Inbox") รายการนี้มีวัตถุเมตาดาต้าของข้อความซึ่งมักรวมถึงข้อมูลเช่น ID ของข้อความ, หมายเลขลำดับ, UID และอาจมีข้อมูลสรุปเช่นหัวเรื่องหรือข้อมูลผู้ส่ง

โค้ดสแน็ปด้านล่างแสดงวิธีดึงข้อมูลเมตาดาต้าของข้อความจากกล่องขาเข้าและพิมพ์จำนวนข้อความทั้งหมดที่มี:

import aspose.email as ae

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

client.select_folder("Inbox")

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

แสดงรายการข้อความด้วยการสนับสนุนการแบ่งหน้า

ในกรณีที่เซิร์ฟเวอร์อีเมลมีข้อความจำนวนมากในกล่องจดหมาย มักต้องการแสดงรายการหรือดึงข้อความโดยสนับสนุนการแบ่งหน้า Aspose.Email ImapClient คลาสที่ให้คุณดึงข้อความจากเซิร์ฟเวอร์ตามการสนับสนุนการแบ่งหน้า.

แสดงรายการข้อความแบบเรียกซ้ำ

โปรโตคอล IMAP อนุญาตให้แสดงรายการข้อความจากโฟลเดอร์กล่องจดหมายแบบเรียกซ้ำ ซึ่งทำให้สามารถแสดงรายการข้อความจากโฟลเดอร์ย่อยได้ด้วย โค้ดสแน็ปด้านล่างแสดงวิธีแสดงรายการข้อความแบบเรียกซ้ำ:

แสดงรายการ MIME Message IDs

นี้ ImapMessageInfo คลาสให้วิธีที่สะดวกในการเข้าถึง MIME MessageId เพื่อระบุตัวข้อความโดยไม่ต้องสกัดเนื้อหาข้อความทั้งหมด ด้านล่างเป็นโค้ดสแน็ปที่แสดงวิธีแสดงรายการ MIME MessageId:

แสดงรายการข้อความด้วย MultiConnection

นี้ ImapClient คลาสมีคุณสมบัติ use_multi_connection ที่ทำให้ใช้การเชื่อมต่อหลายครั้งสำหรับการดำเนินการที่มีโหลดสูง นอกจากนี้คุณสามารถระบุจำนวนการเชื่อมต่อในโหมดหลายการเชื่อมต่อโดยใช้คุณสมบัติ connections_quantity ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้โหมดหลายการเชื่อมต่อสำหรับการแสดงรายการข้อความ:

import aspose.email as ae

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

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

message_info_col = client.list_messages(True)

โปรดทราบว่า การใช้โหมดนี้ไม่ได้จำเป็นต้องทำให้ประสิทธิภาพเพิ่มขึ้น

ดึงข้อความตามหมายเลขลำดับหรือ ID เฉพาะ

API ของ Aspose.Email อนุญาตให้คุณสร้างรายการข้อความสองรายการ หนึ่งที่มีหมายเลขลำดับและอีกหนึ่งที่มี ID เฉพาะของข้อความทั้งหมดในกล่องจดหมาย เพื่อดึงข้อความจากเซิร์ฟเวอร์ IMAP ตามตัวระบุ ให้ใช้เมธอด fetch_messages ของ ImapClient คลาส โค้ดสแน็ปด้านล่างแสดงวิธีแสดงรายการข้อความโดยใช้ตัวระบุ:

import aspose.email as ae

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

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

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

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

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

ดึงข้อความในลำดับจากมากไปน้อย

งานนี้ทำได้โดยกำหนดการตั้งค่าการแบ่งหน้าสำหรับการดึงข้อความ เพื่อวัตถุประสงค์นี้ใช้คุณสมบัติ ascending_sorting ของ PageSettings คลาสที่เป็นส่วนหนึ่งของโมดูลไคลเอนต์ IMAP ตั้งแอต tribute 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 ระบุไดเรกทอรีและเพิ่ม ID เฉพาะลงในชื่อไฟล์เพื่อความไม่ซ้ำกัน

โค้ดสแน็ปต่อไปนี้แสดงวิธีดึงข้อความอีเมลจากเซิร์ฟเวอร์และบันทึกไว้:

บันทึกข้อความในรูปแบบ 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 ด้วย Python API

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

การสนับสนุนส่วนขยาย IMAP

API ของ Aspose.Email รองรับส่วนขยายหลายประเภทของโปรโตคอล IMAP ส่วนขยายเหล่านี้ทำให้สามารถทำงานขั้นสูงได้ เช่น การระบุแอปพลิเคชันของไคลเอนต์และการดึงข้อมูลเมตาดาต้ากล่องจดหมายอย่างละเอียด แม้ว่าเซิร์ฟเวอร์อีเมลทั้งหมดจะไม่รองรับฟีเจอร์เหล่านี้ แต่บริการยอดนิยมหลายแห่งเช่น Gmail รองรับ

บทความนี้แสดงวิธีการใช้ส่วนขยาย IMAP ต่อไปนี้กับ ImapClient คลาสใน Aspose.Email:

คำสั่ง IMAP ID
คำสั่ง IMAP LIST-EXTENDED

การใช้คำสั่ง IMAP ID

คำสั่งนี้ให้ข้อมูลตอบกลับว่าเซิร์ฟเวอร์รองรับส่วนขยาย IMAP ID หรือไม่และส่งคืนรายละเอียดการระบุตัวแบบโครงสร้างจากเซิร์ฟเวอร์ ซึ่งอาจเป็นประโยชน์ต่อการบันทึก, การวินิจฉัย, และการปรับแต่งพฤติกรรมของเซิร์ฟเวอร์

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการใช้ไลบรารี Aspose.Email เพื่อโต้ตอบกับเซิร์ฟเวอร์ IMAP โดยเฉพาะการดึงข้อมูลการระบุตัวเซิร์ฟเวอร์โดยใช้คำสั่ง ID:

import aspose.email as ae

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

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

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

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

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

การใช้คำสั่ง IMAP LIST-EXTENDED

คำสั่ง IMAP LIST-EXTENDED (กำหนดใน RFC 5258) ช่วยให้ไคลเอนต์ดึงข้อมูลโครงสร้างโฟลเดอร์และเมตาดาต้าอย่างละเอียด เช่นว่าโฟลเดอร์มีโฟลเดอร์ย่อยหรือไม่ สิ่งนี้มีประโยชน์โดยเฉพาะสำหรับไคลเอนต์ที่จัดการโครงสร้างกล่องจดหมายที่ซับซ้อน

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการแสดงรายการโฟลเดอร์ใน Gmail โดยใช้คำสั่ง 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 ใน Python

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

Aspose.Email สำหรับ Python มีวิธีการของ ImapClient คลาสสำหรับจัดการข้อความอีเมลผ่านโปรโตคอล IMAP:

วิธีการ ‘backup’
วิธีการ ‘restore’

บทความนี้แสดงวิธีการใช้ ImapClient คลาสและวิธีการของมันเพื่อสำรองและกู้คืนข้อความอีเมลไปยังและจากไฟล์ PST นอกจากนี้ยังครอบคลุมวิธีการเพิ่มประสิทธิภาพสำหรับกล่องจดหมายขนาดใหญ่โดยใช้โหมด multi-connection

สำรองข้อความ 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)