Class MailApp

Aplikacja Poczta

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 GmailApp jedynym celem MailApp jest wysyłanie e-maili. MailApp nie może uzyskać dostępu do skrzynki odbiorczej Gmaila użytkownika.

Zmiany w skryptach napisanych za pomocą GmailApp częściej powodują prośbę o ponowne udzielenie autoryzacji przez użytkownika niż skrypty MailApp.

Metody

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

Szczegółowa dokumentacja

getRemainingDailyQuota()

Zwraca liczbę adresatów, do których możesz wysyłać e-maile do końca dnia. Zwrócona wartość jest ważna dla bieżącego wykonania 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 usług Google. 

const 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, które korzystają 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-maile; Ta odmiana metody jest znacznie bardziej elastyczna i zawiera więcej opcji. 

// 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: '[email protected]',     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 JavaScriptu reprezentujący wiadomość e-mail;

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablica plików do wysłania z e-mailem.
bccStringlista adresów e-mail do pola UDW rozdzielane przecinkami.
bodyStringtreść e-maila.
ccStringlistę adresów e-mail do umieszczenia w polu DW, rozdzielonych przecinkami.
htmlBodyStringjeśli jest ustawiony, urządzenia, które mogą renderować HTML, będą używać go zamiast wymaganego argumentu body; możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wstawione obrazy w e-mailu
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody i zawiera on odwołania do tych obrazów w formacie <img src="cid:imageKey" /> (patrz przykład)
nameStringimię i nazwisko nadawcy e-maila. Domyślnie jest to nazwa użytkownika nadawcy.
noReplyBooleantrue czy e-mail ma być wysyłany z ogólnego adresu e-mail bez możliwości odpowiedzi, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest możliwa tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila
replyToStringadres e-mail, który ma być używany jako domyślny adres, na który mają być wysyłane odpowiedzi (domyślnie: adres e-mail użytkownika). Jeśli noReply ma wartość true, replyTo jest ignorowany.
subjectStringtemat e-maila,
toStringadres e-mail adresata lub lista adresów e-mail rozdzielonych przecinkami, które mają być adresowane do adresatów;

Autoryzacja

Skrypty, które korzystają 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-maile; 

MailApp.sendEmail(     '[email protected]',     'TPS reports',     'Where are the TPS reports?', );

Parametry

NazwaTypOpis
recipientStringadresy adresatów, rozdzielone przecinkami.
subjectStringwiersz tematu.
bodyStringtreść e-maila.

Autoryzacja

Skrypty, które korzystają 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 wiadomość e-mail z opcjonalnymi argumentami. 

// 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(     '[email protected]',     'Attachment example',     'Two files are attached.',     {       name: 'Automatic Emailer Script',       attachments: [file.getAs(MimeType.PDF), blob],     }, );

Parametry

NazwaTypOpis
recipientStringadresy adresatów, rozdzielone przecinkami.
subjectStringwiersz tematu.
bodyStringtreść e-maila.
optionsObjectobiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania z e-mailem (patrz przykład)
bccStringlista adresów e-mail do pola UDW rozdzielane przecinkami.
ccStringlistę adresów e-mail do umieszczenia w polu DW, rozdzielonych przecinkami.
htmlBodyStringjeśli jest ustawiony, urządzenia, które mogą renderować HTML, będą używać go zamiast wymaganego argumentu body; możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wstawione obrazy w e-mailu
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody i zawiera on odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie imię i nazwisko użytkownika);
noReplyBooleantrue czy e-mail ma być wysyłany z ogólnego adresu e-mail bez możliwości odpowiedzi, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest możliwa tylko w przypadku kont Google Workspace, a nie 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, które korzystają 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-maile; Ta metoda umożliwia użytkownikowi łatwe określenie adresu Odpowiedź-do dla wysłanej wiadomości, który może różnić się od adresu nadawcy. 

MailApp.sendEmail(     '[email protected]',     '[email protected]',     'TPS report status',     'What is the status of those TPS reports?', );

Parametry

NazwaTypOpis
toStringadresy adresatów, rozdzielone przecinkami.
replyToStringadres zwrotny.
subjectStringwiersz tematu.
bodyStringtreść e-maila w postaci zwykłego tekstu.

Autoryzacja

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

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