Class MailApp

MailApp

wysyła e-maile;

Ta usługa umożliwia użytkownikom wysyłanie e-maili z pełną kontrolą nad ich treścią. W przeciwieństwie do aplikacji GmailApp jedynym przeznaczeniem aplikacji MailApp jest wysyłanie e-maili. MailApp nie może uzyskać dostępu do skrzynki odbiorczej użytkownika w Gmailu.

Zmiany w skryptach napisanych za pomocą aplikacji GmailApp częściej powodują wysłanie przez użytkownika żądania ponownej autoryzacji niż w skryptach MailApp.

Metody

MetodaZwracany typKrótki opis
getRemainingDailyQuota()IntegerZwraca liczbę odbiorców, do których możesz wysył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 wysyłać e-maile do końca dnia. Zwrócona wartość jest prawidłowa w bieżącym wykonaniu i może się różnić w zależności od wykonania.

Limity zależą od liczby odbiorców e-maili. Więcej informacji o limitach znajdziesz w artykule Limity w usługach Google.

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

Powroty

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

Upoważnienie

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 i daje wiele możliwości.

// 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[]tablicę plików do wysłania w e-mailu.
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
bodyStringtreść e-maila,
ccStringoddziel adresy e-mail przecinkami
htmlBodyStringJeśli zasada jest skonfigurowana, urządzenia mogące renderować kod HTML będą używać go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz w e-mailu obrazy w treści.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i że zawiera on odwołania do tych obrazów w formacie <img src="cid:imageKey" /> (zobacz przykład)
nameStringnazwa nadawcy e-maila. Domyślnie jest to nazwa użytkownika nadawcy.
noReplyBooleantrue, jeśli e-mail powinien zostać wysłany z ogólnego adresu e-mail służącego do wysyłania wiadomości tylko w celu zniechęcenia odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie użytkowników Gmaila.
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika). Jeśli noReply ma wartość true, replyTo jest ignorowana.
subjectStringtemat e-maila.
toStringadres e-mail odbiorcy lub oddzielona przecinkami lista adresów e-mail, które mają być adresatami;

Upoważnienie

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,

Upoważnienie

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 parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania w e-mailu (zobacz przykład).
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
ccStringoddziel adresy e-mail przecinkami
htmlBodyStringJeśli zasada jest skonfigurowana, urządzenia mogące renderować kod HTML będą używać go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz w e-mailu obrazy w treści.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
noReplyBooleantrue, jeśli e-mail powinien zostać wysłany z ogólnego adresu e-mail służącego do wysyłania wiadomości tylko w celu zniechęcenia odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie użytkowników Gmaila.
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika)

Upoważnienie

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 wysłanej wiadomości, który może różnić się od adresu 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 zwykłym tekstem,

Upoważnienie

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

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