Menghantar E-mel dengan MSGraph SDK dalam Python

Alice Dupont

Jumaat, 19 April 2024 12:39:11 PTG

Bermula dengan MSGraph Python SDK
Mengintegrasikan API Graf Microsoft untuk mengurus e-mel dalam aplikasi Python menjadi kemahiran penting untuk pembangun. Teknik ini membenarkan pengendalian automatik mesej e-mel secara terus melalui Python, meningkatkan fungsi dalam pelbagai aplikasi perusahaan. Tumpuan di sini adalah untuk menggunakan MSGraph SDK untuk menghantar semula mesej daripada peti mel pengguna dengan cekap.
Walau bagaimanapun, seseorang mungkin menghadapi masalah dengan kehilangan fail atau kelas semasa melaksanakan kod sampel yang disediakan, seperti kelas SendMailPostRequestBody yang tidak hadir. Panduan ini bertujuan untuk menangani cabaran ini, mencadangkan penyelesaian untuk menghantar e-mel secara berkesan, termasuk lampiran, tanpa bergantung pada perpustakaan alternatif seperti permintaan.

Perintah Penerangan

GraphClient Memulakan pelanggan untuk berinteraksi dengan Microsoft Graph API, menggunakan token OAuth yang disediakan untuk pengesahan.

OAuth2Session Mencipta sesi untuk pengesahan OAuth 2 yang memudahkan pemerolehan dan pengendalian token.

fetch_token Mengambil token OAuth daripada titik akhir token platform identiti Microsoft.

api() Membina URL permintaan untuk titik akhir Microsoft Graph API tertentu untuk melaksanakan tindakan seperti menghantar e-mel.

post() Melaksanakan permintaan POST menggunakan titik akhir API yang dibina, menghantar data seperti e-mel melalui Microsoft Graph API.

BackendApplicationClient Pelanggan digunakan untuk komunikasi pelayan-ke-pelayan yang mana bukti kelayakan pengguna tidak digunakan, hanya bukti kelayakan pelanggan.

Perintah	Penerangan
GraphClient	Memulakan pelanggan untuk berinteraksi dengan Microsoft Graph API, menggunakan token OAuth yang disediakan untuk pengesahan.
OAuth2Session	Mencipta sesi untuk pengesahan OAuth 2 yang memudahkan pemerolehan dan pengendalian token.
fetch_token	Mengambil token OAuth daripada titik akhir token platform identiti Microsoft.
api()	Membina URL permintaan untuk titik akhir Microsoft Graph API tertentu untuk melaksanakan tindakan seperti menghantar e-mel.
post()	Melaksanakan permintaan POST menggunakan titik akhir API yang dibina, menghantar data seperti e-mel melalui Microsoft Graph API.
BackendApplicationClient	Pelanggan digunakan untuk komunikasi pelayan-ke-pelayan yang mana bukti kelayakan pengguna tidak digunakan, hanya bukti kelayakan pelanggan.

Pecahan Terperinci Skrip Python untuk Operasi E-mel MSGraph

Skrip Python yang disediakan direka bentuk untuk membolehkan operasi e-mel melalui Microsoft Graph API, khususnya menyasarkan senario di mana aplikasi perlu mengautomasikan tugas menghantar e-mel. Penggunaan `GraphClient` daripada MSGraph SDK membolehkan interaksi langsung dengan perkhidmatan Microsoft, membolehkan tindakan seperti menghantar e-mel. Persediaan klien ini bermula dengan mewujudkan aliran pengesahan dengan token OAuth, difasilitasi oleh `OAuth2Session` dan `BackendApplicationClient`. Persediaan ini penting untuk mengakses Microsoft Graph API dengan selamat tanpa interaksi pengguna, memfokuskan pada komunikasi pelayan-ke-pelayan.

Setelah pengesahan berjaya diwujudkan dan token diperoleh menggunakan kaedah `fetch_token`, skrip membina dan menghantar e-mel menggunakan kaedah `api` dan `post`. Perintah ini berinteraksi secara langsung dengan titik akhir '/me/sendMail' Graph API. Kandungan e-mel, penerima dan butiran lain ditentukan dalam format berstruktur yang diperlukan oleh API Graf. Skrip ini mencontohkan pelaksanaan praktikal untuk mengautomasikan proses e-mel dalam aplikasi perniagaan, terutamanya berguna apabila menyepadukan dengan sistem perusahaan yang bergantung pada ekosistem Microsoft.

Automasi E-mel dengan MSGraph dan Python SDK

Skrip Python untuk Operasi E-mel MSGraph

from msgraph.core import GraphClient
from oauthlib.oauth2 import BackendApplicationClient
from requests_oauthlib import OAuth2Session
client_id = 'YOUR_CLIENT_ID'
client_secret = 'YOUR_CLIENT_SECRET'
tenant_id = 'YOUR_TENANT_ID'
token_url = f'https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token'
client = BackendApplicationClient(client_id=client_id)
oauth = OAuth2Session(client=client)
token = oauth.fetch_token(token_url=token_url, client_id=client_id, client_secret=client_secret)
client = GraphClient(credential=token)
message = {
    "subject": "Meet for lunch?",
    "body": {
        "contentType": "Text",
        "content": "The new cafeteria is open."
    },
    "toRecipients": [{
        "emailAddress": {"address": "frannis@contoso.com"}
    }],
    "ccRecipients": [{
        "emailAddress": {"address": "danas@contoso.com"}
    }]
}
save_to_sent_items = False
response = client.api('/me/sendMail').post({"message": message, "saveToSentItems": str(save_to_sent_items).lower()})
print(response.status_code)

Menangani Kelas Hilang dalam MSGraph SDK

Pengendalian Ralat dalam Python untuk API MSGraph

class SendMailPostRequestBody:
    def __init__(self, message, save_to_sent_items):
        self.message = message
        self.save_to_sent_items = save_to_sent_items
try:
    from msgraph.generated.models import Message, Recipient, EmailAddress
except ImportError as e:
    print(f"Failed to import MSGraph models: {str(e)}")
    # Define missing classes manually if not available
    class Message:
        def __init__(self, subject, body, to_recipients, cc_recipients):
            self.subject = subject
            self.body = body
            self.to_recipients = to_recipients
            self.cc_recipients = cc_recipients
    class Recipient:
        def __init__(self, email_address):
            self.email_address = email_address
    class EmailAddress:
        def __init__(self, address):
            self.address = address

Memperluas Keupayaan E-mel MSGraph dalam Python

Apabila menggunakan Microsoft Graph API dengan Python untuk operasi e-mel, memahami keupayaannya yang lebih luas adalah penting. Selain menghantar e-mel asas, API Graf menyokong fungsi lanjutan seperti mengurus lampiran e-mel, menetapkan kepentingan mesej dan mengendalikan resit dibaca. Ciri ini membolehkan pembangun mencipta penyelesaian e-mel yang lebih canggih dan interaktif yang disesuaikan dengan keperluan perniagaan. Keupayaan untuk memasukkan lampiran secara pengaturcaraan, sebagai contoh, adalah penting untuk mengautomasikan penyebaran laporan, invois atau kemas kini yang dijadualkan.

Selain itu, menyepadukan ciri lanjutan ini memerlukan pemahaman tentang model komprehensif API Graf untuk item mel, yang merangkumi sifat dan kaedah terperinci untuk memanipulasi komponen e-mel. Pembangun boleh menyesuaikan e-mel pada tahap yang besar, seperti membenamkan kandungan HTML yang kaya, pengepala tersuai dan mengkonfigurasi tetapan keselamatan seperti penyulitan. Kebolehsuaian ini menjadikan MSGraph sebagai alat yang berkuasa untuk persekitaran perusahaan di mana komunikasi e-mel selalunya merupakan bahagian penting dalam automasi aliran kerja.

Bagaimanakah saya boleh mengesahkan API Microsoft Graph dalam Python?
Pengesahan boleh dilakukan menggunakan protokol OAuth 2.0. Kaedah biasa melibatkan mendapatkan token akses daripada titik akhir platform identiti Microsoft.
Bolehkah saya menghantar lampiran menggunakan MSGraph dalam Python?
Ya, anda boleh menghantar lampiran dengan membina muatan JSON yang sesuai yang merangkumi butiran lampiran dan menggunakan kaedah sendMail.
Adakah mungkin untuk menghantar e-mel berformat HTML dengan MSGraph?
Ya, API Graf menyokong kandungan HTML dalam e-mel. Anda perlu menetapkan jenis kandungan badan e-mel kepada HTML.
Bagaimanakah saya boleh menambah penerima CC dan BCC dalam e-mel menggunakan MSGraph?
Penerima CC dan BCC boleh ditambah dengan memasukkan alamat e-mel mereka dalam medan ccRecipients dan bccRecipients objek mesej.
Bolehkah saya membaca dan memproses e-mel masuk dengan MSGraph?
Ya, MSGraph menyediakan fungsi untuk membaca e-mel daripada peti mel pengguna, yang kemudiannya boleh diproses atau disimpan mengikut keperluan.

Melalui penerokaan Microsoft Graph API dan Python SDKnya, pembangun dilengkapi dengan alatan berkuasa untuk mengautomasikan operasi e-mel dalam aplikasi mereka. Keupayaan untuk mengurus e-mel secara pemrograman, termasuk lampiran dan format kandungan yang kaya, membolehkan strategi komunikasi yang lebih dinamik dan berfungsi dalam perniagaan. Contoh dan garis panduan yang disediakan membantu memastikan pelaksanaan yang lancar, menjadikan MSGraph sebagai aset berharga untuk pembangun yang bekerja dalam persekitaran yang berteraskan Microsoft.