שליחת אימייל באמצעות Mail API

במדריך הזה מוסבר איך להשתמש ב-Mail API כדי לשלוח אימייל.

‫Mail API מספק שתי דרכים לשליחת הודעת אימייל: הפונקציה mail.send_mail() והסיווג EmailMessage.

השליחה היא אסינכרונית: הפונקציה mail.send_mail() והשיטה EmailMessage.send() מעבירות את נתוני ההודעה לשירות הדואר, ואז חוזרות. שירות הדואר מוסיף את ההודעה לתור, ואז מנסה לשלוח אותה. אם שרת הדואר של היעד לא זמין, הוא מנסה שוב. הודעות שגיאה והודעות על אי-מסירה חוזרות לשולח של הודעת האימייל.

לפני שמתחילים

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

שליחת דואר באמצעות mail.send_mail()

כדי לשלוח אימייל באמצעות הפונקציה mail.send_mail(), צריך להשתמש בשדות של הודעת האימייל כפרמטרים, כולל השולח, הנמענים, הנושא וגוף ההודעה. לדוגמה:

    mail.send_mail(sender=sender_address,
                   to="Albert Johnson <Albert.Johnson@example.com>",
                   subject="Your account has been approved",
                   body="""Dear Albert:

Your example.com account has been approved.  You can now visit
http://www.example.com/ and sign in using your Google Account to
access new features.

Please let us know if you have any questions.

The example.com Team
""")

שליחת דואר באמצעות EmailMessage

כדי לשלוח אימייל באמצעות אובייקטים עם המחלקה EmailMessage, מעבירים את השדות של הודעת האימייל אל הבונה EmailMessage ומשתמשים במאפיינים של המופע כדי לעדכן את ההודעה.

השיטה EmailMessage.send() שולחת את הודעת האימייל שמיוצגת על ידי מאפייני המופע. אפליקציה יכולה לעשות שימוש חוזר במופע EmailMessage על ידי שינוי מאפיינים והפעלת השיטה send() שוב.

    message = mail.EmailMessage(
        sender=sender_address,
        subject="Your account has been approved")

    message.to = "Albert Johnson <Albert.Johnson@example.com>"
    message.body = """Dear Albert:

Your example.com account has been approved.  You can now visit
http://www.example.com/ and sign in using your Google Account to
access new features.

Please let us know if you have any questions.

The example.com Team
"""
    message.send()

שליחת אימיילים לרשימות תפוצה

בהנחיות לשליחה לרשימות תפוצה מפורטים שיקולים שחשוב לקחת בחשבון כששולחים אימיילים לרשימות תפוצה.

מידע נוסף על שיקולים להעברה של Mail API זמין במדריך Mail handlers.