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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getRemainingDailyQuota() | Integer | Zwraca liczbę odbiorców, do których możesz wysyłać e-maile do końca dnia. |
sendEmail(message) | void | Wysyła e-maila. |
sendEmail(recipient, subject, body) | void | Wysyła e-maila. |
sendEmail(recipient, subject, body, options) | void | Wysyła e-maila z opcjonalnymi argumentami. |
sendEmail(to, replyTo, subject, body) | void | Wysył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
Nazwa | Typ | Opis |
---|---|---|
message | Object | obiekt JavaScript reprezentujący wiadomość e-mail |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablicę plików do wysłania w e-mailu. |
bcc | String | rozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW |
body | String | treść e-maila, |
cc | String | oddziel adresy e-mail przecinkami |
htmlBody | String | Jeś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. |
inlineImages | Object | obiekt 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) |
name | String | nazwa nadawcy e-maila. Domyślnie jest to nazwa użytkownika nadawcy. |
noReply | Boolean | true , 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. |
replyTo | String | adres 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. |
subject | String | temat e-maila. |
to | String | adres 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
Nazwa | Typ | Opis |
---|---|---|
recipient | String | adresy odbiorców rozdzielone przecinkami |
subject | String | wiersz tematu |
body | String | treść 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
Nazwa | Typ | Opis |
---|---|---|
recipient | String | adresy odbiorców rozdzielone przecinkami |
subject | String | wiersz tematu |
body | String | treść e-maila, |
options | Object | obiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablicę plików do wysłania w e-mailu (zobacz przykład). |
bcc | String | rozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW |
cc | String | oddziel adresy e-mail przecinkami |
htmlBody | String | Jeś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. |
inlineImages | Object | obiekt 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" /> |
name | String | nazwa nadawcy e-maila (domyślnie: nazwa użytkownika), |
noReply | Boolean | true , 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. |
replyTo | String | adres 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
Nazwa | Typ | Opis |
---|---|---|
to | String | adresy odbiorców rozdzielone przecinkami |
replyTo | String | adres zwrotny |
subject | String | wiersz tematu |
body | String | treść 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