Class MailApp

MailApp

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

MethodeRückgabetypKurzbeschreibung
getRemainingDailyQuota()IntegerGibt die Anzahl der Empfänger zurück, an die Sie für den Rest des Tages E-Mails senden können.
sendEmail(message)voidSendet eine E-Mail-Nachricht.
sendEmail(recipient, subject, body)voidSendet eine E-Mail-Nachricht.
sendEmail(recipient, subject, body, options)voidSendet eine E-Mail-Nachricht mit optionalen Argumenten.
sendEmail(to, replyTo, subject, body)voidSendet 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

NameTypBeschreibung
messageObjectEin JavaScript-Objekt, das eine E-Mail-Nachricht darstellt

Erweiterte Parameter

NameTypBeschreibung
attachmentsBlobSource[]eine Array der Dateien, die mit der E-Mail gesendet werden sollen
bccStringeine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc
bodyStringden Text der E-Mail
ccStringeine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld
htmlBodyStringWenn 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
inlineImagesObjectJavaScript-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).
nameStringden Namen des Absenders der E-Mail. Standardeinstellung ist die des Absenders Nutzernamen.
noReplyBooleantrue, 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
replyToStringeine 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.
subjectStringden Betreff der E-Mail
toStringdie 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

NameTypBeschreibung
recipientStringdie Adressen der Empfänger, getrennt durch Kommas
subjectStringdie Betreffzeile
bodyStringden 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

NameTypBeschreibung
recipientStringdie Adressen der Empfänger, getrennt durch Kommas
subjectStringdie Betreffzeile
bodyStringden Text der E-Mail
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt

Erweiterte Parameter

NameTypBeschreibung
attachmentsBlobSource[]eine Array der Dateien, die mit der E-Mail gesendet werden sollen (siehe Beispiel)
bccStringeine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc
ccStringeine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld
htmlBodyStringWenn 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
inlineImagesObjectJavaScript-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.
nameStringDer Name des Absenders der E-Mail (Standard: der Name des Nutzers)
noReplyBooleantrue, 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
replyToStringeine 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

NameTypBeschreibung
toStringdie Adressen der Empfänger, getrennt durch Kommas
replyToStringdie Antwortadresse
subjectStringdie Betreffzeile
bodyStringden 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