Diese Seite wurde von der Cloud Translation API übersetzt.

Class MailApp

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
`getRemainingDailyQuota()`	`Integer`	Gibt die Anzahl der Empfänger zurück, an die Sie noch E-Mails senden können.
`sendEmail(message)`	`void`	Eine E-Mail wird gesendet.
`sendEmail(recipient, subject, body)`	`void`	Eine E-Mail wird gesendet.
`sendEmail(recipient, subject, body, options)`	`void`	Sendet eine E-Mail-Nachricht mit optionalen Argumenten.
`sendEmail(to, replyTo, subject, body)`	`void`	Eine E-Mail wird gesendet.

Detaillierte Dokumentation

`getRemainingDailyQuota()`

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

`sendEmail(message)`

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`	`BlobSource[]`	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
`htmlBody`	`String`	Wenn festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales `inlineImages`-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben.
`inlineImages`	`Object`	ein JavaScript-Objekt mit einer Zuordnung von Bildschlüssel (`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" />` enthält (siehe Beispiel)
`name`	`String`	den Namen des Absenders der E-Mail. Standardmäßig ist dies der Nutzername des Absenders.
`noReply`	`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.
`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 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

sendEmail(recipient, subject, body, options)

`sendEmail(recipient, subject, body)`

Eine E-Mail wird gesendet.

MailApp.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

`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.
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`	`BlobSource[]`	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
`htmlBody`	`String`	Wenn festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales `inlineImages`-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben.
`inlineImages`	`Object`	ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (`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" />` enthält
`name`	`String`	den Namen des Absenders der E-Mail (Standard: Name des Nutzers)
`noReply`	`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.
`replyTo`	`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

sendEmail(message)

`sendEmail(to, replyTo, subject, body)`

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.

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, durch Kommas getrennt
`replyTo`	`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