Documentation – Ръководство за разработчици

Python-Net: Работа с MIME съобщения

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

Python-Net: Работа с MIME съобщения

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

Python-Net: Управление на Gmail съобщения в Python

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

Aspose.Email за Python чрез .NET предоставя разширени възможности за работа с Gmail акаунти чрез IGmailClient клас. Това включва изброяване, изпращане, добавяне, извличане и изтриване на съобщения, както и управление на Gmail филтри.

Преди да използвате IGmailClient, аутентицирайте се, като използвате вашия client ID, client secret, refresh token и имейл адрес. След това създайте инстанция на Gmail клиент:

from aspose.email.clients.google import GmailClient

client = GmailClient.get_instance(client_id, client_secret, refresh_token, email)

Изпращане на имейл с помощта на Gmail API

За да изпратите имейл с прикачен файл чрез Gmail акаунт, използвайте send_message метод на IGmailClient клас.

Следният примерен код демонстрира как да създадете и изпратите имейл с прикачен файл, използвайки Gmail API:

from aspose.email import MailMessage, Attachment

# Create the message
message = MailMessage("sender@example.com", "recipient@example.com", "Weekly Report", "Attached is the weekly report.")

# Add an attachment
attachment_path = "path/to/report.pdf"
message.attachments.add(Attachment(attachment_path))

# Send the message
message_id = client.send_message(message)
print(f"Message with attachment sent! ID: {message_id}")

Добавяне на съобщение към Gmail папка

За да добавяте съобщения директно към Gmail пощенска кутия, заобикаляйки стандартната класификация, използвайте следните методи:

append_message(msg) за поведение по подразбиране.
append_message(msg, label_name) за да зададете персонализиран етикет.

Следният примерен код демонстрира как да създадете имейл съобщение и да го добавите към входящата поща на получателя със специфичен етикет, използвайки Gmail клиента:

message = MailMessage("sender@example.com", "recipient@example.com", "Subject for inbox message", "Body of the message")

# Append the message to the inbox with a label
message_id = client.append_message(message, "INBOX")
print(f"Message appended to the Inbox. ID: {message_id}")

Списък на Gmail съобщения

Можете да извлечете списък с всички съобщения в Gmail пощенска кутия, използвайки list_messages() метод на IGmailClient клас. Всеки елемент в върнатия списък е GmailMessageInfo обект, съдържащ леко метаданни като ‘id’ и ’thread_id’.

Следният примерен код демонстрира как да извлечете и покажете информация за всички Gmail съобщения в входящата поща на потребителя:

# List all Gmail messages
messages = client.list_messages()

# Print basic info for each message
for i, msg_info in enumerate(messages):
    print(f"Message {i + 1}: ID = {msg_info.id}, Thread ID = {msg_info.thread_id}")

Извличане на съдържание на Gmail съобщение

След извличане на метаданните на съобщението, използвайте fetch_message(message_id) за да изтеглите пълното съдържание на конкретно съобщение като MailMessage обект. Това позволява достъп до тема, тяло, прикачени файлове и други детайли на съобщението.

Следният примерен код демонстрира как да извлечете и покажете съдържанието на първите три Gmail съобщения от входящата поща на потребителя:

# Fetch and display content for the first 3 messages
for i in range(min(3, len(messages))):
    message = client.fetch_message(messages[i].id)
    print(f"Message {i + 1}")
    print("Subject:", message.subject)
    print("Body:", message.body)

Изтриване на Gmail съобщения

Използвайте delete_message(message_id, move_to_trash) метод на IGmailClient клас за изтриване на съобщение. Можете или да го преместите в кошчето (незавременно) или да го изтриете незабавно и завинаги, като пропуснете втория параметър или зададете False.

Следният примерен код демонстрира как да преместите първите три съобщения от списък с съобщения (например имейли) в кошчето:

# Move the first 3 messages to trash
for i in range(min(3, len(messages))):
    client.delete_message(messages[i].id, True)  # True = move to trash
    print(f"Message {i + 1} moved to trash.")

Manage Gmail Filters

Aspose.Email за Python предоставя следните методи на IGmailClient клас за автоматизиране на процеса по създаване на филтър за организиране на входящи имейли въз основа на темата им и управление на съществуващите филтри в Google имейл акаунт:

list_filters() - Извлича всички филтри, приложени към пощенската кутия.
create_filter(filter) - Добавя нов филтър с персонализирани критерии и действия.
get_filter(id) - Извлича детайли за конкретен филтър.
delete_filter(id) - Премахва филтрите завинаги.

Create and List Gmail Filters

Следният примерен код демонстрира как да създадете и управлявате имейл филтър, използвайки библиотеката Aspose.Email специално за Google клиент:

from aspose.email.clients.google.filters import Filter, Criteria, Action

# Create a new filter
filter_obj = Filter()
filter_obj.matching_criteria = Criteria()
filter_obj.matching_criteria.subject = "Important"

filter_obj.action = Action()
filter_obj.action.add_label_ids = ["IMPORTANT"]

# Create the filter
filter_id = client.create_filter(filter_obj)
print(f"Filter created! ID: {filter_id}")

# List all filters
filters = client.list_filters()
for f in filters:
    print(f"Filter ID: {f.id}")

Delete Gmail Filters

Следният примерен код показва как да премахнете всички филтри от Gmail акаунта:

filters = client.list_filters()

# Delete each filter
for f in filters:
    client.delete_filter(f.id)
    print(f"Filter ID: {f.id} deleted.")

Python-Net: Работа със срещи

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

Зареждане и запазване на среща във формат ICS

Класът Appointment в Aspose.Email API може да се използва за зареждане на среща във формат ICS, както и за създаване на нова среща и запазването ѝ на диск във формат ICS. В тази статия първо създаваме среща и я запазваме на диск във формат ICS, след което я зареждаме.

Създаване на среща и запазване на диск във формат ICS

Необходими са следните стъпки за създаване на среща и запазването ѝ в формат ICS.

Създайте инстанция на класа Appointment и я инициализирайте с този конструктор.
Предайте следните аргументи в горния конструктор
1. Участници
2. Описание
3. Крайна дата
4. Местоположение
5. Организатор
6. Начална дата
7. Резюме
Извикайте метода Save() и задайте името на файла и формата в аргументите.

Срещата може да бъде отворена в Microsoft Outlook или всяка програма, която може да зареди файл ICS. Ако файлът се отвори в Microsoft Outlook, той автоматично добавя срещата в календара на Outlook.

Следните кодови откъси показват как да създадете и запазите среща на диск във формат ICS.

Зареждане на среща във формат ICS

За да заредите среща във формат ICS, необходимите стъпки са следните:

Създайте инстанция на класа Appointment.
Извикайте метода Load(), като предоставите пътя до ICS файла.
Прочетете всяко свойство, за да получите информация от назначението (ICS файл).

Следните кодови откъси показват как да заредите среща във формат ICS.

Четене на множество събития от ICS файл

Записване на множество събития в ICS файл

Създаване на заявка за чернова на среща

В предишните ни статии беше показано как да се създаде и запази среща във формат ICS. Често се изисква създаване на заявка за среща в режим Чернова, така че след добавяне на основната информация същата чернова да бъде препратена към други потребители за необходимите промени според индивидуалните потребители. За да запазите среща в режим Чернова, свойството Method на класа Appointment трябва да бъде зададено на Publish. Следният кодов откъс показва как да създадете заявка за чернова на среща.

Създаване на чернова на среща от текст

Следният кодов откъс показва как да създадете чернова на среща от Текст.

Задаване на статус на участниците в срещата

Aspose.Email за .NET API ви позволява да зададете статус на участниците в срещата, докато формулирате отговорно съобщение. Това добавя свойството PARTSTAT към файла ICS.

Python-Net: Управление на срещи в Python

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

Създаване и запазване на срещи

Този Appointment клас в Aspose.Email API може да се използва за зареждане на среща във формат ICS, както и за създаване на нова и запазването ѝ на диск във формат ICS.

Създаване на среща и запазване като ICS

Следните кодови откъси показват как да създадете и запазите среща на диск във формат ICS:

Създайте инстанция на MailAddressCollection за съхранение на имейл адресите на участниците и добавяне на имейл на участник към MailAddressCollection използвайки append() метод.
Използвайте Appointment конструктор за създаване на нова среща с детайли като местоположение, начално време, крайна дата, имейл на организатора и списък с участници.
Задайте свойства на срещата – резюме и описание – за описване на конкретните детайли на събитието.
Запазете срещата във формат ICS, като използвате save() метод, който задава пътя към файла и формата.

Създаване на заявка за чернова на среща

Често се изисква създаване на заявка за среща в режим Чернова, така че основната информация да бъде добавена и след това същата чернова да бъде препратена към други потребители за необходимите промени според индивидуалните заявки. За да запазите среща в режим Чернова, method_type свойство на Appointment класът трябва да бъде зададен на ‘publish’. Следният кодов откъс показва как да създадете заявка за чернова на среща.

Чернова на среща от Текст

Следният кодов откъс показва как да създадете чернова на среща от Текст.

Зареждане и четене на срещи

Зареждане на срещи от ICS файлове

Следният кодов откъс показва как да заредите среща във формат ICS:

Използвайте Appointment.load() метод за зареждане на среща от съществуващ ICS файл, като се указва пътят.
Извлечете и покажете детайлите на срещата: резюме, местоположение, описание, начална дата, крайна дата, организатор и участници.

Четене на множество събития отICS файлове

С Aspose.Email можете да прочетете всички събития от даден ICS файл и да ги съхраните в списък, след което да изведете общия брой срещи. Следният примерен код демонстрира как да изпълните тази задача:

Използвайте CalendarReader клас за инициализиране на читател, който ще обработва ICS файл, съдържащ календарни събития. Укажете местоположението на ICS файла в конструктора.
Създайте празен списък с име ‘appointments’ за съхранение на събитията, прочетени от ICS файла.
Итерирате през всяко събитие в ICS файла, използвайки reader.next_event().
Добавете текущото събитие (reader.current) към списъка със срещи.
Изведете общия брой срещи.

Писане и актуализиране на срещи

Записване на множество събития в ICS файлове

Създайте и запазете множество събития в ICS файл, като всяко събитие съдържа конкретни детайли като участници, местоположение, време и описателна информация. Следният примерен код ще ви покаже как да създадете и запазите множество събития за срещи в календарен файл ICS:

Създайте инстанция на IcsSaveOptions за да укажете как ще бъдат запазени календарните събития.
Задайте свойството action на AppointmentAction.CREATE, за да укажете, че срещите трябва да бъдат създадени в ICS файла.
Използвайте CalendarWriter клас за настройка на писател за изписване на събития в ICS файл, като се предостави пътят до изходния файл и преди това дефинираните опции за запазване.
Създайте MailAddressCollection за управление на списъка с участници за всяка среща. Добавете конкретен имейл адрес към тази колекция, използвайки метода append.
Итерирате 10 пъти, използвайки for цикъл, съответстващ на създаването на 10 събития за срещи. За всяка итерация създайте Appointment инстанция със зададени детайли като местоположение, начално време, крайна дата, имейл на организатора и участници.
Добавете детайли за събитието: свойства за описание и резюме.
Използвайте write метод на писателя за изписване на срещата в ICS файла.

Задаване на статус на участник за участници в среща

Aspose.Email за .NET API позволява задаване на статусите на участниците в срещата, докато се формулира отговорно съобщение. Като присвоите тези статуси на всеки участник, приложението или системата, работеща с обекта Appointment, може да обработва логика, свързана със събития, като показване на потвърдени участници, проследяване на промени или управление на известия съобразно това.

Python-Net: Работа с Outlook елементи

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

Python-Net: Работа с Outlook елементи

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

Python-Net: Работа с файлoве за съхранение на Outlook (OST или PST)

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

Python-Net: Работа с SMTP клиент

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

Python-Net: Работа с POP3 клиент

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

Python-Net: Работа с IMAP клиент

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

Python-Net: Програмиране с Thunderbird

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

Четене на съобщения

Mozilla Thunderbird е отворен източник, крос‑платформен имейл клиент, разработен от Mozilla Foundation. Той съхранява имейли в своя собствена файлова структура, управлявайки индекси на съобщения и подпапки чрез собственостни файлови формати. Aspose.Email може да работи с структури за съхранение на поща на Thunderbird. Класът MboxrdStorageReader позволява на разработчиците да четат съобщения от файл за съхранение на поща на Mozilla Thunderbird. Тази статия показва как да се прочетат съобщенията от хранилището на Thunderbird:

Отворете файлът за съхранение на Thunderbird
Създайте екземпляр на класа MboxrdStorageReader и предайте горния поток на конструктора.
Извикайте read_next_message() за да получите първото съобщение.
Използвайте същото read_next_message() в while цикъл, за да прочетете всички съобщения.
Затворете всички потоци.

Следният кодов фрагмент показва как да прочетете всички съобщения от хранилището на поща на Thunderbird.

Извличане на свойства на съобщението

За да прочетете и извлечете информация от Mbox файл, Aspose.Email предоставя MboxStorageReader клас за създаване на обект за четене на Mbox файл и MboxLoadOptions клас за зареждане на файла. Следните свойства на MboxMessageInfo класът може да бъде използван за достъп и показване на конкретни детайли на съобщението:

‘date’ - Получава датата на съобщението.
‘from_address’ - Получава адреса на подателя.
‘subject’ - Взема темата на съобщението.
’to’ - Взема колекцията от адреси, съдържаща получателите на съобщението.
‘cc’ - Взема колекцията от адреси, съдържаща получателите CC.
‘bcc’ - Взема колекцията от адреси, съдържаща получателите BCC на съобщението.

Следният примерен код демонстрира използването на тези свойства за четене и извличане на информация за съобщения от Mbox файл:

import aspose.email as ae

reader = ae.storage.mbox.MboxStorageReader.create_reader(file_name, ae.storage.mbox.MboxLoadOptions())

for mbox_message_info in reader.enumerate_message_info():
    print(f"Subject: {mbox_message_info.subject}")
    print(f"Date: {mbox_message_info.date}")
    print(f"From: {mbox_message_info.from_address}")
    print(f"To: {mbox_message_info.to}")
    print(f"CC: {mbox_message_info.cc}")
    print(f"Bcc: {mbox_message_info.bcc}")

Извличане на съобщения от MBOX по идентификатори

За да чете съобщения от MBOX файл, Aspose.Email предоставя метода ‘create_reader()’ на MboxStorageReader клас за създаване на обект-четец за файла. Приема името на файла и MboxLoadOptions като аргументи, позволявайки на потребителя да зареди MBOX файла със специални опции, ако е необходимо.

За извличане на съобщения се използват следните методи и свойства:

метод ’enumerate_message_info()’ на MboxStorageReader клас - Итерара чрез всяко съобщение в MBOX файла.
метод ’extract_message()" на MboxStorageReader клас - Извлича всяко съобщение по неговия Entry ID.
свойство ’entry_id’ на MboxMessageInfo клас - Взема идентификатора на елемент.

Накрая, съобщението се конвертира в EML формат, като се използва EmlLoadOptions.

Следният примерен код демонстрира използването на тези функции за четене и извличане на съобщения от MBOX файл:

import aspose.email as ae

reader = ae.storage.mbox.MboxStorageReader.create_reader("my.mbox", ae.storage.mbox.MboxLoadOptions())

for mbox_message_info in reader.enumerate_message_info():
    eml = reader.extract_message(mbox_message_info.entry_id, ae.EmlLoadOptions())

Конфигуриране на опциите за зареждане при четене на съобщения от MBOX

С Aspose.Email EmlLoadOptions клас, можете да зададете допълнителни опции при зареждане на MailMessage от Eml формат. Например, можете да зададете опция за запазване на TNEF прикачени файлове, като използвате свойството ‘preserve_tnef_attachments’ на EmlLoadOptions клас.

Можете да прочетете следващото имейл съобщение от mbox файла, използвайки зададените опции за зареждане, с метода ‘read_next_message’ на MboxStorageReader клас и конвертирайте файла към PST формат с метода ‘mbox_to_pst’ на MailStorageConverter клас .

Следният примерен код демонстрира използването на тези методи и свойства за работа с файлове за съхранение на имейли, включително четене на съобщения от mbox формат, запазване на TNEF прикачени файлове и конвертиране на съобщения от mbox към pst формат:

import aspose.email as ae

reader = ae.storage.mbox.MboxrdStorageReader(fileName, ae.storage.mbox.MboxLoadOptions())
# Read messages preserving tnef attachments.
load_options = ae.EmlLoadOptions()
load_options.preserve_tnef_attachments = True
eml = reader.read_next_message(load_options)
ae.storage.MailStorageConverter.MboxMessageOptions(load_options)
# Convert messages from mbox to pst preserving tnef attachments.
pst = ae.storage.MailStorageConverter.mbox_to_pst("Input.mbox", "Output.pst")

Задаване на предпочитано текстово кодиране при зареждане на Mbox файлове за четене

Можете да зададете текстовото кодиране, което да се използва при зареждане на MBOX файл. Свойството ‘preferred_text_encoding’ е достъпно за MboxLoadOptions класът задава допълнителна опция и гарантира, че съобщението с кодираното съдържание ще бъде правилно прочетено и обработено.

Следният кодов отрезък показва как да се използва тази функция в проект:

import aspose.email as ae

load_options = ae.storage.mbox.MboxLoadOptions()
load_options.preferred_text_encoding = 'utf-8'
reader = ae.storage.mbox.MboxrdStorageReader("sample.mbox", load_options)
message = reader.read_next_message()

Конвертиране на MBOX към PST със запазване или премахване на подпис

За да премахнете подписа от файл по време на процеса на конвертиране, задайте свойството MboxToPstConversionOptions.remove_signature на true.

Следният примерен код показва как да се използва това свойство:

import aspose.email as ae

personalStorage = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)
conversion_options = ae.storage.MboxToPstConversionOptions()
conversion_options.remove_signature = True
ae.storage.MailStorageConverter.mbox_to_pst( ae.storage.mbox.MboxrdStorageReader("source.mbox", ae.storage.mbox.MboxLoadOptions()), personalStorage, "Inbox", conversion_options)

Писане на съобщения

Класът MboxrdStorageWriter предоставя възможност за записване на нови съобщения във файл за съхранение на поща на Thunderbird. За да записвате съобщения:

Отворете файлът за съхранение на Thunderbird във FileStream.
Създайте екземпляр на класа MboxrdStorageWriter и предайте горния поток на конструктора.
Подгответе ново съобщение, използвайки класа MailMessage.
Извикайте метода write_message() и предайте горния екземпляр на MailMessage, за да добавите съобщението към съхранението на Thunderbird.
Затворете всички потоци.

Следният кодов фрагмент ви показва как да записва съобщения в хранилището на поща на Thunderbird.

Получаване на общия брой съобщения от MBox файл

Класът MboxrdStorageReader предоставя възможност за четене на броя налични елементи в MBox файл. Това може да се използва за разработване на приложения, показващи прогреса на активността при обработка на такъв файл.

Documentation – Ръководство за разработчици

Python-Net: Работа с MIME съобщения

Python-Net: Работа с MIME съобщения

Python-Net: Управление на Gmail съобщения в Python

Изпращане на имейл с помощта на Gmail API

Добавяне на съобщение към Gmail папка

Списък на Gmail съобщения

Извличане на съдържание на Gmail съобщение

Изтриване на Gmail съобщения

Manage Gmail Filters

Create and List Gmail Filters

Delete Gmail Filters

Python-Net: Работа със срещи

Зареждане и запазване на среща във формат ICS

Създаване на среща и запазване на диск във формат ICS

Зареждане на среща във формат ICS

Четене на множество събития от ICS файл

Записване на множество събития в ICS файл

Създаване на заявка за чернова на среща

Създаване на чернова на среща от текст

Задаване на статус на участниците в срещата

Python-Net: Управление на срещи в Python

Създаване и запазване на срещи

Създаване на среща и запазване като ICS

Създаване на заявка за чернова на среща

Чернова на среща от Текст

Зареждане и четене на срещи

Зареждане на срещи от ICS файлове

Четене на множество събития отICS файлове

Писане и актуализиране на срещи

Записване на множество събития в ICS файлове

Задаване на статус на участник за участници в среща

Python-Net: Работа с Outlook елементи

Python-Net: Работа с Outlook елементи

Python-Net: Работа с файлoве за съхранение на Outlook (OST или PST)

Python-Net: Работа с SMTP клиент

Python-Net: Работа с POP3 клиент

Python-Net: Работа с IMAP клиент

Python-Net: Програмиране с Thunderbird

Четене на съобщения

Извличане на свойства на съобщението

Извличане на съобщения от MBOX по идентификатори

Конфигуриране на опциите за зареждане при четене на съобщения от MBOX

Задаване на предпочитано текстово кодиране при зареждане на Mbox файлове за четене

Конвертиране на MBOX към PST със запазване или премахване на подпис

Писане на съобщения

Получаване на общия брой съобщения от MBox файл

Получете текущия размер на съобщението