E-Mails werden gesendet.
Mit diesem Dienst können Nutzer E-Mails senden und dabei den Inhalt der E-Mail vollständig steuern. Im Gegensatz zu GmailApp dient MailApp ausschließlich dem Senden von E-Mails. MailApp kann nicht auf den Gmail-Posteingang eines Nutzers zugreifen.
Änderungen an Scripts, die mit GmailApp geschrieben wurden, lösen eher eine erneute Autorisierungsanfrage eines Nutzers aus als MailApp-Scripts.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung | 
|---|---|---|
| get | Integer | Gibt die Anzahl der Empfänger zurück, an die Sie noch E-Mails senden können. | 
| send | void | Eine E-Mail wird gesendet. | 
| send | void | Eine E-Mail wird gesendet. | 
| send | void | Sendet eine E-Mail-Nachricht mit optionalen Argumenten. | 
| send | void | Eine E-Mail wird gesendet. | 
Detaillierte Dokumentation
get
Gibt die Anzahl der Empfänger zurück, an die Sie noch E-Mails senden können. Der zurückgegebene Wert ist für die aktuelle Ausführung gültig und kann zwischen den Ausführungen variieren.
Die Kontingente richten sich nach der Anzahl der E-Mail-Empfänger. Spezifische Kontingentinformationen finden Sie unter Kontingente für Google-Dienste.
const emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);
Rückflug
Integer: Die verbleibende Anzahl der E-Mails, die das Script senden kann.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
- 
https://www.googleapis.com/auth/script.send_mail
send
Eine E-Mail wird gesendet. 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() { const googleLogoUrl = 'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png'; const youtubeLogoUrl = 'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png'; const googleLogoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob'); const 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 | Blob | eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen | 
| bcc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion | 
| body | String | im Textkörper der E-Mail | 
| cc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen | 
| html | String | Wenn festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inline-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben. | 
| inline | Object | ein JavaScript-Objekt mit einer Zuordnung von Bildschlüssel ( String) zu Bilddaten (Blob); dabei wird davon ausgegangen, dass der Parameterhtmlverwendet 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. Standardmäßig ist dies der Nutzername des Absenders. | 
| no | Boolean | true, wenn die E-Mail von einer generischen E-Mail-Adresse ohne Antwortfunktion gesendet werden soll, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten verfügbar, nicht für Gmail-Nutzer. | 
| reply | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers). Wenn noauftruegesetzt ist, wirdreplyignoriert. | 
| subject | String | den Betreff der E-Mail | 
| to | String | die E-Mail-Adresse des Empfängers oder eine durch Kommas getrennte Liste der E-Mail-Adressen der Empfänger | 
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
- 
https://www.googleapis.com/auth/script.send_mail
Weitere Informationen
send
Eine E-Mail wird gesendet.
App .sendEmail( 'recipient@example.com', 'TPS reports', 'Where are the TPS reports?', );
Parameter
| Name | Typ | Beschreibung | 
|---|---|---|
| recipient | String | die Adressen der Empfänger, durch Kommas getrennt | 
| subject | String | Betreffzeile | 
| body | String | im Textkörper der E-Mail | 
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
- 
https://www.googleapis.com/auth/script.send_mail
send
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. const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); const 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, durch Kommas getrennt | 
| subject | String | Betreffzeile | 
| body | String | im Textkörper der E-Mail | 
| options | Object | ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt | 
Erweiterte Parameter
| Name | Typ | Beschreibung | 
|---|---|---|
| attachments | Blob | eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen (siehe Beispiel) | 
| bcc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion | 
| cc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen | 
| html | String | Wenn festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inline-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben. | 
| inline | Object | ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln ( String) zu Bilddaten (Blob); dabei wird davon ausgegangen, dass der Parameterhtmlverwendet wird und Verweise auf diese Bilder im Format<img src="cid:imageKey" />enthält | 
| name | String | den Namen des Absenders der E-Mail (Standard: Name des Nutzers) | 
| no | Boolean | true, wenn die E-Mail von einer generischen E-Mail-Adresse ohne Antwortfunktion gesendet werden soll, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten verfügbar, nicht für Gmail-Nutzer. | 
| reply | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) | 
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
- 
https://www.googleapis.com/auth/script.send_mail
Weitere Informationen
send
Eine E-Mail wird gesendet. Mit dieser Methode kann ein Nutzer ganz einfach eine Antwortadresse für die gesendete Nachricht angeben, die sich vom Absender unterscheiden kann.
App .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, durch Kommas getrennt | 
| reply | String | die Antwortadresse | 
| subject | String | Betreffzeile | 
| body | String | den Textkörper der E-Mail im Nur-Text-Format | 
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
- 
https://www.googleapis.com/auth/script.send_mail