Class MailApp

MailApp

Wysyła e-maila.

Ta usługa pozwala użytkownikom wysyłać e-maile z pełną kontrolą nad ich treścią. W przeciwieństwie do aplikacji GmailApp jedynym przeznaczeniem aplikacji MailApp jest wysyłanie e-maili. Aplikacja MailApp nie ma dostępu do Gmaila użytkownika Odebrane.

Zmiany w skryptach napisanych przy użyciu aplikacji GmailApp z większym prawdopodobieństwem spowodują ponowną autoryzację żądania wysyłane przez użytkownika niż skrypty MailApp.

Metody

MetodaZwracany typKrótki opis
getRemainingDailyQuota()IntegerZwraca liczbę odbiorców, do których możesz wysłać e-maile do końca dnia.
sendEmail(message)voidWysyła e-maila.
sendEmail(recipient, subject, body)voidWysyła e-maila.
sendEmail(recipient, subject, body, options)voidWysyła e-maila z opcjonalnymi argumentami.
sendEmail(to, replyTo, subject, body)voidWysyła e-maila.

Szczegółowa dokumentacja

getRemainingDailyQuota()

Zwraca liczbę odbiorców, do których możesz wysłać e-maile do końca dnia. Zwrócone wartości jest prawidłowa w bieżącym wykonaniu i może się różnić w zależności od wykonania.

Limity są ustalane na podstawie liczby odbiorców e-maili. Szczegółowe informacje o limitach znajdziesz w artykule Limity dla Google Usługi.

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

Powrót

Integer – liczba pozostałych e-maili, które skrypt może wysłać.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

sendEmail(message)

Wysyła e-maila. Ta odmiana metody jest znacznie bardziej elastyczna, dzięki czemu więcej opcji.

// 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
      }
  });
}

Parametry

NazwaTypOpis
messageObjectobiekt JavaScript reprezentujący wiadomość e-mail

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania e-mailem
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
bodyStringtreść e-maila
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
htmlBodyStringJeśli jest ustawiony, będą go używać urządzenia, które potrafią renderować kod HTML wymaganego argumentu body; opcjonalne pole inlineImages można dodać w kodzie HTML treść, jeśli e-mail zawiera obrazy w tekście.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że jest używany parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" /> (patrz przykład)
nameStringnazwa nadawcy e-maila. Domyślnie jest to wartość nadawcy nazwa użytkownika.
noReplyBooleantrue, jeśli e-mail ma być wysłany z ogólnego adresu adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila.
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika). Jeśli noReply ma wartość true, replyTo jest ignorowana.
subjectStringtemat e-maila
toStringadres e-mail odbiorcy lub rozdzielaną przecinkami listę adresy e-mail odbiorców

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


sendEmail(recipient, subject, body)

Wysyła e-maila.

MailApp.sendEmail("recipient@example.com",
                  "TPS reports",
                  "Where are the TPS reports?");

Parametry

NazwaTypOpis
recipientStringadresy odbiorców rozdzielone przecinkami
subjectStringwiersz tematu
bodyStringtreść e-maila

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

sendEmail(recipient, subject, body, options)

Wysyła e-maila z opcjonalnymi argumentami.

// 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]
});

Parametry

NazwaTypOpis
recipientStringadresy odbiorców rozdzielone przecinkami
subjectStringwiersz tematu
bodyStringtreść e-maila
optionsObjectobiekt JavaScript, który określa zaawansowane parametry, jak pokazano poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania z e-mailem (zobacz przykład)
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
htmlBodyStringJeśli jest ustawiony, będą go używać urządzenia, które potrafią renderować kod HTML wymaganego argumentu body; opcjonalne pole inlineImages można dodać w kodzie HTML treść, jeśli e-mail zawiera obrazy w tekście.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika);
noReplyBooleantrue, jeśli e-mail ma być wysłany z ogólnego adresu adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila.
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika)

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


sendEmail(to, replyTo, subject, body)

Wysyła e-maila. Ta metoda pozwala użytkownikowi łatwo określić adres zwrotny dla wiadomości wysłano wiadomość, która może się różnić od nadawcy.

MailApp.sendEmail("recipient@example.com",
                  "replies@example.com",
                  "TPS report status",
                  "What is the status of those TPS reports?");

Parametry

NazwaTypOpis
toStringadresy odbiorców rozdzielone przecinkami
replyToStringadres zwrotny
subjectStringwiersz tematu
bodyStringtreść e-maila jako zwykły tekst;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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