Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit der E-Mail-API können Sie E-Mail-Nachrichten auf zwei verschiedene Arten versenden: die mail.send_mail()-Funktion und die EmailMessage-Klasse.
Das Senden erfolgt asynchron: Die Funktion mail.send_mail() und die Methode EmailMessage.send() übertragen die Nachrichtendaten an den E-Mail-Dienst und nehmen anschließend Daten vom Dienst entgegen. Der E-Mail-Dienst reiht die Nachricht in die Warteschlange ein und versucht anschließend, die Nachricht zu senden. Der Vorgang wird wiederholt, wenn der E-Mail-Zielserver nicht verfügbar ist. Fehler und Unzustellbarkeitsnachrichten werden an die Adresse des Absenders der E-Mail-Nachricht gesendet.
Vorbereitung
Sie müssen Ihre Absenderadressen als autorisierte Absender registrieren. Weitere Informationen finden Sie unter Wer kann E-Mails senden?.
E-Mails mit mail.send_mail() senden
Zum Senden von E-Mails mit der Funktion mail.send_mail() verwenden Sie die Felder der E-Mail-Nachricht als Parameter, einschließlich Absender, Empfänger, Betreff und Nachrichtentext. Beispiel:
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 visithttp://www.example.com/ and sign in using your Google Account toaccess new features.Please let us know if you have any questions.The example.com Team""")
E-Mails mit EmailMessage senden
Wenn Sie E-Mails über Objekte mit der Klasse EmailMessage senden möchten, übergeben Sie die Felder der E-Mail-Nachricht an den EmailMessage-Konstruktor und verwenden Sie Attribute der Instanz, um die Nachricht zu aktualisieren.
Die Methode EmailMessage.send() sendet die E-Mail-Nachricht, wie sie durch die Attribute der Instanz dargestellt wird. Zur Wiederverwendung einer Instanz von EmailMessage können Anwendungen Attribute ändern und die Methode send() noch einmal aufrufen.
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 visithttp://www.example.com/ and sign in using your Google Account toaccess new features.Please let us know if you have any questions.The example.com Team"""message.send()
Das folgende Beispiel veranschaulicht, wie eine Nachricht zum Bestätigen einer E-Mail-Adresse gesendet wird.
classUserSignupHandler(webapp2.RequestHandler):"""Serves the email address sign up form."""defpost(self):user_address=self.request.get('email_address')ifnotmail.is_email_valid(user_address):self.get()# Show the form again.else:confirmation_url=create_new_user_confirmation(user_address)sender_address=('Example.com Support <{}@appspot.gserviceaccount.com>'.format(app_identity.get_application_id()))subject='Confirm your registration'body="""Thank you for creating an account!Please confirm your email address by clicking on the link below:{}""".format(confirmation_url)mail.send_mail(sender_address,user_address,subject,body)
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eThe mail API offers two methods for sending emails: the \u003ccode\u003email.send_mail()\u003c/code\u003e function and the \u003ccode\u003eEmailMessage\u003c/code\u003e class.\u003c/p\u003e\n"],["\u003cp\u003eEmail sending is asynchronous, meaning the function or method returns immediately after sending the message data to the mail service, which then queues and attempts delivery.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API you need to register your sender emails as authorized senders.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003email.send_mail()\u003c/code\u003e function takes email fields as parameters, whereas the \u003ccode\u003eEmailMessage\u003c/code\u003e class uses attributes of an instance to construct and send emails.\u003c/p\u003e\n"],["\u003cp\u003eThis API can only run in first-generation runtimes in the App Engine standard environment.\u003c/p\u003e\n"]]],[],null,["# Sending Mail\n\nThe mail API provides two ways to send an email message: the\n[`mail.send_mail()`](/appengine/docs/legacy/standard/python/refdocs/google.appengine.api.mail#google.appengine.api.mail.send_mail) function and the [`EmailMessage`](/appengine/docs/legacy/standard/python/refdocs/google.appengine.api.mail#google.appengine.api.mail.EmailMessage) class.\n| This page describes how to use the legacy bundled services and APIs. This API can only run in first-generation runtimes in the App Engine standard environment. If you are updating to the App Engine Python 3 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/python-differences) to learn about your migration options for legacy bundled services.\n\nSending is asynchronous: the `mail.send_mail()` function and the\n`EmailMessage.send()` method transmit the message data to the mail\nservice, then return. The mail service queues the message, then attempts to\nsend it, retrying if the destination mail server is unavailable. Errors and\nbounce messages are sent to the sender address for the email message.\n\nBefore you begin\n----------------\n\nYou must register your sender emails as authorized senders. For more\ninformation, see\n[who can send email](/appengine/docs/legacy/standard/python/mail#who_can_send_mail).\n\nSending mail with `mail.send_mail()`\n------------------------------------\n\nTo send mail using the [`mail.send_mail()`](/appengine/docs/legacy/standard/python/refdocs/google.appengine.api.mail#google.appengine.api.mail.send_mail) function, use the fields of the\nemail message as parameters, including the sender, the recipients, the subject\nand the body of the message. For example: \n\n mail.send_mail(sender=sender_address,\n to=\"Albert Johnson \u003cAlbert.Johnson@example.com\u003e\",\n subject=\"Your account has been approved\",\n body=\"\"\"Dear Albert:\n\n Your example.com account has been approved. You can now visit\n http://www.example.com/ and sign in using your Google Account to\n access new features.\n\n Please let us know if you have any questions.\n\n The example.com Team\n \"\"\")\n\nSending mail with `EmailMessage`\n--------------------------------\n\nTo send mail using objects with the\n[`EmailMessage`](/appengine/docs/legacy/standard/python/refdocs/google.appengine.api.mail#google.appengine.api.mail.EmailMessage) class, pass the fields of the email message to\nthe EmailMessage constructor and use attributes of the instance to update\nmessage.\n\nThe [`EmailMessage.send()`](/appengine/docs/legacy/standard/python/refdocs/modules/google/appengine/api/mail#EmailMessage) method sends the email message\nrepresented by the instance's attributes. An application can re-use an\n`EmailMessage` instance by modifying attributes and calling the `send()` method\nagain. \n\n message = mail.EmailMessage(\n sender=sender_address,\n subject=\"Your account has been approved\")\n\n message.to = \"Albert Johnson \u003cAlbert.Johnson@example.com\u003e\"\n message.body = \"\"\"Dear Albert:\n\n Your example.com account has been approved. You can now visit\n http://www.example.com/ and sign in using your Google Account to\n access new features.\n\n Please let us know if you have any questions.\n\n The example.com Team\n \"\"\"\n message.send()\n\nThe following example demonstrates sending a message to confirm an email\naddress: \n\n class UserSignupHandler(webapp2.RequestHandler):\n \"\"\"Serves the email address sign up form.\"\"\"\n\n def post(self):\n user_address = self.request.get('email_address')\n\n if not mail.is_email_valid(user_address):\n self.get() # Show the form again.\n else:\n confirmation_url = create_new_user_confirmation(user_address)\n sender_address = (\n 'Example.com Support \u003c{}@appspot.gserviceaccount.com\u003e'.format(\n app_identity.get_application_id()))\n subject = 'Confirm your registration'\n body = \"\"\"Thank you for creating an account!\n Please confirm your email address by clicking on the link below:\n\n {}\n \"\"\".format(confirmation_url)\n mail.send_mail(sender_address, user_address, subject, body)\n\nSending bulk mail\n-----------------\n\nSee the [Bulk mail guidelines](/appengine/docs/legacy/standard/python/mail/bulk-mail) for considerations around sending bulk\nemail."]]
