Sendet E-Mails.
Mit diesem Dienst können Nutzer E-Mails versenden und haben dabei vollständige Kontrolle über den Inhalt der E-Mails. Im Gegensatz zu GmailApp besteht der einzige Zweck von MailApp darin, E-Mails zu senden. MailApp kann nicht auf das Gmail-Konto eines Nutzers zugreifen Posteingang.
Bei Änderungen an Skripts, die mit der GmailApp erstellt wurden, ist die Wahrscheinlichkeit höher, dass eine erneute Autorisierung durchgeführt wird von einem Nutzer anfordern als 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. Die zurückgegebene ist für die aktuelle Ausführung gültig und kann je nach Ausführung 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);
Rückflug
Integer
: Die Anzahl der verbleibenden E-Mails, die das Skript senden kann.
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 wesentlich flexibler und ermöglicht 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[] | eine Array der Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc |
body | String | den Text der E-Mail |
cc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld |
htmlBody | String | Wenn festgelegt, wird HTML-Code von Geräten, die HTML rendern können, verwendet
des erforderlichen Arguments "body"; können Sie ein optionales inlineImages -Feld in HTML
Text, wenn Sie Inline-Bilder für Ihre E-Mail haben |
inlineImages | Object | JavaScript-Objekt, das eine Zuordnung vom Image-Schlüssel enthält
(String ) zu Bilddaten (BlobSource ); Dabei wird davon ausgegangen, dass der htmlBody -Parameter verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthalten sind (siehe Beispiel). |
name | String | den Namen des Absenders der E-Mail. Standardeinstellung ist die des Absenders Nutzernamen. |
noReply | Boolean | true , wenn die E-Mail von einer allgemeinen E-Mail-Adresse gesendet werden soll
Antwort-E-Mail-Adresse, um Empfänger davon abzuhalten, auf E-Mails zu antworten ist diese Option
nur für Google Workspace-Konten möglich, nicht für Gmail-Nutzer |
replyTo | String | eine E-Mail-Adresse, die als Standard-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 kommagetrennte Liste als Empfänger von E-Mail-Adressen |
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 | die Betreffzeile |
body | String | den Text der E-Mail |
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 | die Betreffzeile |
body | String | den Text der E-Mail |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | eine Array der 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 für das Cc-Feld |
htmlBody | String | Wenn festgelegt, wird HTML-Code von Geräten, die HTML rendern können, verwendet
des erforderlichen Arguments "body"; können Sie ein optionales inlineImages -Feld in HTML
Text, wenn Sie Inline-Bilder für Ihre E-Mail haben |
inlineImages | Object | JavaScript-Objekt, das eine Zuordnung vom Image-Schlüssel enthält
(String ) zu Bilddaten (BlobSource ); Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthalten sind. |
name | String | Der Name des Absenders der E-Mail (Standard: der Name des Nutzers) |
noReply | Boolean | true , wenn die E-Mail von einer allgemeinen E-Mail-Adresse gesendet werden soll
Antwort-E-Mail-Adresse, um Empfänger davon abzuhalten, auf E-Mails zu antworten ist diese Option
nur für Google Workspace-Konten möglich, nicht für Gmail-Nutzer |
replyTo | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: 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 können Nutzer auf einfache Weise eine Antwortadresse für die gesendete Nachricht, 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 | die Betreffzeile |
body | String | den Text der E-Mail als Nur-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