Es gibt zwei Möglichkeiten, E-Mails mit der Gmail API zu senden:
- Sie können sie direkt mit der Methode
messages.send
senden. - Sie können sie mit der Methode
drafts.send
aus einem Entwurf senden.
E-Mails werden als base64url-codierte Strings im Attribut raw
einer Nachrichtenressource gesendet. Der allgemeine Workflow zum Senden einer E-Mail sieht so aus:
- Erstellen Sie den E-Mail-Inhalt auf eine bequeme Weise und codieren Sie ihn als base64url-String.
- Erstellen Sie eine neue Nachrichtenressource und legen Sie ihre
raw
-Eigenschaft auf den soeben erstellten base64url-String fest. - Rufen Sie
messages.send
oder, wenn Sie einen Entwurf senden,drafts.send
auf, um die Nachricht zu senden.
Die Details dieses Workflows können je nach ausgewählter Clientbibliothek und Programmiersprache variieren.
Nachrichten erstellen
Für die Gmail API sind MIME-E-Mail-Nachrichten erforderlich, die RFC 2822-konform und als base64url-Strings codiert sind. Viele Programmiersprachen haben Bibliotheken oder Dienstprogramme, die das Erstellen und Codieren von MIME-Nachrichten vereinfachen. Die folgenden Codebeispiele zeigen, wie Sie eine MIME-Nachricht mithilfe der Google APIs-Clientbibliotheken für verschiedene Sprachen erstellen.
Java
Mit der Klasse MimeMessage
im Paket javax.mail.internet
lässt sich das Erstellen einer E-Mail-Nachricht stark vereinfachen. Das folgende Beispiel zeigt, wie die E-Mail-Nachricht einschließlich Header erstellt wird:
Im nächsten Schritt müssen Sie MimeMessage
codieren, ein Message
-Objekt instanziieren und den base64url-codierten Nachrichtenstring als Wert des Attributs raw
festlegen.
Python
Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine MIME-Nachricht erstellen, in einem base64url-String codieren und diese dem Feld raw
der Ressource Message
zuweisen:
Nachrichten mit Anhängen erstellen
Eine Nachricht mit einem Anhang wird wie jede andere Nachricht erstellt. Der Vorgang zum Hochladen der Datei als mehrteilige MIME-Nachricht hängt jedoch von der Programmiersprache ab. Die folgenden Codebeispiele zeigen mögliche Möglichkeiten zum Erstellen einer mehrteiligen MIME-Nachricht mit einem Anhang.
Java
Das folgende Beispiel zeigt, wie Sie eine mehrteilige MIME-Nachricht erstellen. Die Codierungs- und Zuweisungsschritte sind die gleichen wie oben.
Python
Ähnlich wie im vorherigen Beispiel wird in diesem Beispiel die Nachricht auch in base64url codiert und dem Feld raw
der Ressource Message
zugewiesen.
Nachrichten senden
Nachdem Sie eine Nachricht erstellt haben, können Sie sie senden, indem Sie sie wie in den folgenden Beispielen gezeigt im Anfragetext eines Aufrufs von messages.send
angeben.
Java
Python
Wenn Sie versuchen, eine Antwort zu senden und die E-Mail in eine Konversation verschieben möchten, achten Sie auf Folgendes:
- Die
Subject
-Header stimmen überein - Die Header
References
undIn-Reply-To
entsprechen dem RFC 2822-Standard.
Informationen zum Senden einer Nachricht aus einem Entwurf finden Sie unter Entwürfe erstellen.