Documentation – Посібник розробника

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: Робота з MIME повідомленнями

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

Python-Net: Робота з MIME повідомленнями

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

Python-Net: Керування подіями в Python

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

Створення та збереження подій

The Appointment клас в Aspose.Email API можна використовувати для завантаження події у форматі ICS, а також для створення нової та збереження її на диск у форматі ICS.

Створити подію та зберегти як ICS

Наступні фрагменти коду показують, як створити та зберегти подію на диск у форматі ICS:

Створіть екземпляр MailAddressCollection для збереження електронних адрес учасників та додавання електронної адреси учасника до MailAddressCollection використовуючи append() метод.
Використайте Appointment конструктор для створення нової події з деталями, такими як місце, час початку, дата завершення, електронна пошта організатора та список учасників.
Встановіть властивості події — резюме та опис — щоб описати специфіку зустрічі.
Збережіть подію у форматі ICS за допомогою save() метод, що вказує шлях до файлу та формат.

Зустріч можна відкрити у Microsoft Outlook або будь‑якій програмі, що вміє завантажувати файли ICS. Якщо файл відкрито у Microsoft Outlook, він автоматично додає зустріч у календар Outlook.

Створити запит чернетки зустрічі

Часто потрібно створити запит на подію у режимі чернетки, щоб базова інформація була додана, а потім ця чернетка могла бути передана іншим користувачам для необхідних змін відповідно до індивідуальних запитів. Щоб зберегти подію у режимі чернетки, 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 for .NET API дозволяє встановлювати статуси учасників події під час формування відповіді. Присвоюючи ці статуси кожному учаснику, застосунок або система, що працює з об’єктом Appointment, може обробляти логіку, пов’язану з подією, наприклад, показувати підтверджених учасників, відстежувати зміни або керувати сповіщеннями відповідно.

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() та вкажіть у параметрах ім’я файлу та формат.

Наступні фрагменти коду показують, як створити та зберегти подію на диск у форматі ICS.

Завантаження події у форматі ICS

Щоб завантажити зустріч у форматі ICS, необхідно виконати наступні кроки:

Створіть екземпляр класу Appointment.
Викличте метод Load(), вказавши шлях до файлу ICS.
Прочитайте будь-яку властивість, щоб отримати будь-яку інформацію про зустріч (файл ICS).

Наступні фрагменти коду показують, як завантажити подію у форматі ICS.

Читання кількох подій з файлу ICS

Запис кількох подій у файл ICS

Створити запит чернетки зустрічі

У наших попередніх статтях було показано, як створити та зберегти подію у форматі ICS. Часто потрібно створити запит на подію у режимі чернетки, щоб базова інформація була додана, а потім ця чернетка могла бути передана іншим користувачам для необхідних змін згідно з індивідуальними запитами. Щоб зберегти подію у режимі чернетки, властивість Method класу Appointment має бути встановлена у Publish. Наступний фрагмент коду показує, як створити запит на чернетку події.

Створення чернетки зустрічі з тексту

Наступний фрагмент коду показує, як створити чернетку події з тексту.

Встановити статус учасників зустрічі

Aspose.Email для .NET API дозволяє встановлювати статус учасників зустрічі під час формування відповіді. Це додає властивість PARTSTAT до файлу ICS.

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

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

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

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

Python-Net: Робота з файлами сховища 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‑вкладень під час завантаження файлу EML за допомогою властивості ‘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: Керування повідомленнями Gmail у Python

Надіслати електронну пошту за допомогою Gmail API

Додати повідомлення до папки Gmail

Список повідомлень Gmail

Отримати вміст повідомлення Gmail

Видалити повідомлення Gmail

Manage Gmail Filters

Create and List Gmail Filters

Delete Gmail Filters

Python-Net: Робота з MIME повідомленнями

Python-Net: Робота з MIME повідомленнями

Python-Net: Керування подіями в Python

Створення та збереження подій

Створити подію та зберегти як ICS

Створити запит чернетки зустрічі

Чернетка події з тексту

Завантаження та читання подій

Завантаження подій з файлів ICS

Читання кількох подій з файлів ICS

Запис та оновлення подій

Запис кількох подій у файли ICS

Встановлення статусу учасників події

Python-Net: Робота з подіями

Завантаження та збереження події у форматі ICS

Створення події та збереження її на диск у форматі ICS

Завантаження події у форматі ICS

Читання кількох подій з файлу ICS

Запис кількох подій у файл ICS

Створити запит чернетки зустрічі

Створення чернетки зустрічі з тексту

Встановити статус учасників зустрічі

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

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

Python-Net: Робота з файлами сховища Outlook (OST або PST)

Python-Net: Робота з SMTP клієнтом

Python-Net: Робота з POP3 клієнтом

Python-Net: Робота з клієнтом IMAP

Python-Net: Програмування з Thunderbird

Читання повідомлень

Отримання властивостей повідомлення

Витяг повідомлень з MBOX за ідентифікаторами

Налаштування параметрів завантаження при читанні повідомлень з MBOX

Встановлення бажаного кодування тексту під час завантаження MBOX‑файлів для читання

Конвертація MBOX у PST із збереженням або видаленням підпису

Запис повідомлень

Отримання загальної кількості повідомлень з файлу MBox

Отримати поточний розмір повідомлення

Читання кількох подій з файлу ICS