E-Mails senden.
Dieser Dienst ermöglicht es Nutzern, E-Mails mit vollständiger Kontrolle über den Inhalt der E-Mail zu senden. Im Gegensatz zu GmailApp dient MailApp ausschließlich zum Senden von E-Mails. MailApp kann nicht auf den Gmail-Posteingang eines Nutzers zugreifen.
Bei Änderungen an Skripts, die mit GmailApp geschrieben wurden, ist die Wahrscheinlichkeit höher, dass ein Nutzer eine erneute Autorisierungsanfrage stellt als bei MailApp-Skripts.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getRemainingDailyQuota() | Integer | Gibt die Anzahl der Empfänger zurück, an die Sie für den Rest des Tages E-Mails senden können. |
sendEmail(message) | void | Sendet eine E-Mail-Nachricht. |
sendEmail(recipient, subject, body) | void | Sendet eine E-Mail-Nachricht. |
sendEmail(recipient, subject, body, options) | void | Sendet eine E-Mail-Nachricht mit optionalen Argumenten. |
sendEmail(to, replyTo, subject, body) | void | Sendet eine E-Mail-Nachricht. |
Detaillierte Dokumentation
getRemainingDailyQuota()
Gibt die Anzahl der Empfänger zurück, an die Sie für den Rest des Tages E-Mails senden können. Der zurückgegebene Wert ist für die aktuelle Ausführung gültig und kann zwischen Ausführungen variieren.
Kontingente basieren auf der Anzahl der E-Mail-Empfänger. Spezifische Kontingentinformationen finden Sie unter Kontingente für Google-Dienste.
var emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log("Remaining email quota: " + emailQuotaRemaining);
Return
Integer
: Die Anzahl der verbleibenden E-Mails, die vom Skript gesendet werden können.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(message)
Sendet eine E-Mail-Nachricht. Diese Variante der Methode ist viel flexibler und bietet viele weitere Optionen.
// This code fetches the Google and YouTube logos, inlines them in an email // and sends the email function inlineImage() { var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png"; var youtubeLogoUrl = "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png"; var googleLogoBlob = UrlFetchApp .fetch(googleLogoUrl) .getBlob() .setName("googleLogoBlob"); var youtubeLogoBlob = UrlFetchApp .fetch(youtubeLogoUrl) .getBlob() .setName("youtubeLogoBlob"); MailApp.sendEmail({ to: "recipient@example.com", subject: "Logos", htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" + "inline YouTube Logo <img src='cid:youtubeLogo'>", inlineImages: { googleLogo: googleLogoBlob, youtubeLogo: youtubeLogoBlob } }); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
message | Object | Ein JavaScript-Objekt, das eine E-Mail-Nachricht darstellt |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | Ein Array von Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc |
body | String | Der E-Mail-Text |
cc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Cc gesetzt werden sollen |
htmlBody | String | Ist die Richtlinie festgelegt, verwenden Geräte, die HTML rendern können, dieses Argument anstelle des erforderlichen Textarguments. Wenn du Inline-Bilder für deine E-Mail hast, kannst du ein optionales inlineImages -Feld im HTML-Text hinzufügen. |
inlineImages | Object | Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String ) zu Bilddaten (BlobSource ) enthält. Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält (siehe Beispiel). |
name | String | den Namen des Absenders der E-Mail. Die Standardeinstellung ist der Nutzername des Absenders. |
noReply | Boolean | true , wenn die E-Mail von einer generischen E-Mail-Adresse gesendet werden soll, von der keine Antworten gesendet werden können, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten und nicht für Gmail-Nutzer möglich. |
replyTo | String | Eine E-Mail-Adresse, die als standardmäßige Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers). Wenn noReply auf true gesetzt ist, wird replyTo ignoriert. |
subject | String | den Betreff der E-Mail |
to | String | Die E-Mail-Adresse des Empfängers oder eine durch Kommas getrennte Liste von E-Mail-Adressen als Empfänger |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.send_mail
Weitere Informationen
sendEmail(recipient, subject, body)
Sendet eine E-Mail-Nachricht.
MailApp.sendEmail("recipient@example.com", "TPS reports", "Where are the TPS reports?");
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | die Adressen der Empfänger, getrennt durch Kommas |
subject | String | in der Betreffzeile |
body | String | Der E-Mail-Text |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body, options)
Sendet eine E-Mail-Nachricht mit optionalen Argumenten.
// Send an email with two attachments: a file from Google Drive (as a PDF) and an HTML file. var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); var blob = Utilities.newBlob('Insert any HTML content here', 'text/html', 'my_document.html'); MailApp.sendEmail('mike@example.com', 'Attachment example', 'Two files are attached.', { name: 'Automatic Emailer Script', attachments: [file.getAs(MimeType.PDF), blob] });
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | die Adressen der Empfänger, getrennt durch Kommas |
subject | String | in der Betreffzeile |
body | String | Der E-Mail-Text |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | Ein Array von Dateien, die mit der E-Mail gesendet werden sollen (siehe Beispiel) |
bcc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc |
cc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Cc gesetzt werden sollen |
htmlBody | String | Ist die Richtlinie festgelegt, verwenden Geräte, die HTML rendern können, dieses Argument anstelle des erforderlichen Textarguments. Wenn du Inline-Bilder für deine E-Mail hast, kannst du ein optionales inlineImages -Feld im HTML-Text hinzufügen. |
inlineImages | Object | Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String ) zu Bilddaten (BlobSource ) enthält. Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält. |
name | String | den Namen des Absenders der E-Mail (Standard: der Name des Nutzers) |
noReply | Boolean | true , wenn die E-Mail von einer generischen E-Mail-Adresse gesendet werden soll, von der keine Antworten gesendet werden können, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten und nicht für Gmail-Nutzer möglich. |
replyTo | String | eine E-Mail-Adresse, die als standardmäßige Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.send_mail
Weitere Informationen
sendEmail(to, replyTo, subject, body)
Sendet eine E-Mail-Nachricht. Mit dieser Methode kann ein Nutzer auf einfache Weise eine Antwortadresse für die gesendete Nachricht angeben, die sich vom Absender unterscheiden kann.
MailApp.sendEmail("recipient@example.com", "replies@example.com", "TPS report status", "What is the status of those TPS reports?");
Parameter
Name | Typ | Beschreibung |
---|---|---|
to | String | die Adressen der Empfänger, getrennt durch Kommas |
replyTo | String | die Antwortadresse |
subject | String | in der Betreffzeile |
body | String | E-Mail-Text im Nur-Text-Format |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.send_mail