Class MailApp

E-Mails senden.

Mit diesem Dienst können Nutzer E-Mails senden und haben dabei die vollständige Kontrolle über den Inhalt der E-Mail. Im Gegensatz zu GmailApp dient MailApp ausschließlich zum Senden von E‑Mails. MailApp kann nicht auf den Gmail-Posteingang eines Nutzers zugreifen.

Änderungen an Skripts, die mit GmailApp geschrieben wurden, lösen eher eine erneute Autorisierungsanfrage an einen Nutzer aus 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. Der zurückgegebene Wert ist für die aktuelle Ausführung gültig und kann sich zwischen den Ausführungen ändern.

Kontingente basieren auf 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 Anzahl der verbleibenden E‑Mails, die das Skript senden kann.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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() {
  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[]`	ein Array von Dateien, die mit der E‑Mail gesendet werden sollen
`bcc`	`String`	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in BCC gesetzt werden sollen
`body`	`String`	den Text der E‑Mail
`cc`	`String`	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in Cc gesetzt werden sollen
`htmlBody`	`String`	Wenn dieser Parameter festgelegt ist, verwenden Geräte, die HTML rendern können, ihn anstelle des erforderlichen „body“-Arguments. Sie können dem HTML-Textkörper ein optionales `inlineImages`-Feld hinzufügen, wenn Sie Inline-Bilder für Ihre E-Mail haben.
`inlineImages`	`Object`	ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (`String`) zu den Bilddaten (`BlobSource`) enthält. Dies setzt voraus, dass der Parameter `htmlBody` verwendet wird und Verweise auf diese Bilder im Format `<img src="cid:imageKey" />` enthält (siehe Beispiel).
`name`	`String`	Der Name des Absenders der E‑Mail. Standardmäßig wird der Nutzername des Absenders verwendet.
`noReply`	`Boolean`	`true`, wenn die E‑Mail von einer allgemeinen „Nicht antworten“-E‑Mail-Adresse 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`	der Betreff der E‑Mail
`to`	`String`	die E‑Mail-Adresse des Empfängers oder eine durch Kommas getrennte Liste mit E‑Mail-Adressen der Empfänger

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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, durch Kommas getrennt
`subject`	`String`	die Betreffzeile
`body`	`String`	den Text der E‑Mail

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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`	die Betreffzeile
`body`	`String`	den Text der E‑Mail
`options`	`Object`	Ein JavaScript-Objekt, das erweiterte Parameter angibt (siehe unten)

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 der E‑Mail-Adressen, die in BCC gesetzt werden sollen
`cc`	`String`	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in Cc gesetzt werden sollen
`htmlBody`	`String`	Wenn dieser Parameter festgelegt ist, verwenden Geräte, die HTML rendern können, ihn anstelle des erforderlichen „body“-Arguments. Sie können dem HTML-Textkörper ein optionales `inlineImages`-Feld hinzufügen, wenn Sie Inline-Bilder für Ihre E-Mail haben.
`inlineImages`	`Object`	Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (`String`) zu den Bilddaten (`BlobSource`) enthält. Dies setzt voraus, dass der Parameter `htmlBody` verwendet wird und Verweise auf diese Bilder im Format `<img src="cid:imageKey" />` enthält.
`name`	`String`	Der Name des Absenders der E‑Mail (Standard: der Name des Nutzers)
`noReply`	`Boolean`	`true`, wenn die E‑Mail von einer allgemeinen „Nicht antworten“-E‑Mail-Adresse 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 ganz einfach eine „Antworten an“-Adresse 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`	die Betreffzeile
`body`	`String`	den Text der E‑Mail im Nur-Text-Format

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/script.send_mail

Class MailApp Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Methoden

Detaillierte Dokumentation

getRemainingDailyQuota()

Rückflug

Autorisierung

sendEmail(message)

Parameter

Erweiterte Parameter

Autorisierung

Weitere Informationen

sendEmail(recipient, subject, body)

Parameter

Autorisierung

sendEmail(recipient, subject, body, options)

Parameter

Erweiterte Parameter

Autorisierung

Weitere Informationen

sendEmail(to, replyTo, subject, body)

Parameter

Autorisierung

Class MailApp

`getRemainingDailyQuota()`

`sendEmail(message)`

`sendEmail(recipient, subject, body)`

`sendEmail(recipient, subject, body, options)`

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