Diese Seite wurde von der Cloud Translation API übersetzt.

Class MailApp

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, options)

`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(message)

`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