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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getRemainingDailyQuota() | Integer | Zwraca liczbę odbiorców, do których możesz wysł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 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: "[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
Nazwa | Typ | Opis |
---|---|---|
message | Object | obiekt JavaScript reprezentujący wiadomość e-mail |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania e-mailem |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
body | String | treść e-maila |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
htmlBody | String | Jeś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. |
inlineImages | Object | obiekt 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) |
name | String | nazwa nadawcy e-maila. Domyślnie jest to wartość nadawcy nazwa użytkownika. |
noReply | Boolean | true , 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. |
replyTo | String | adres 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. |
subject | String | temat e-maila |
to | String | adres 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("[email protected]", "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 |
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('[email protected]', '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 zaawansowane parametry, jak pokazano poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania z e-mailem (zobacz przykład) |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
htmlBody | String | Jeś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. |
inlineImages | Object | obiekt 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" /> |
name | String | nazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika); |
noReply | Boolean | true , 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. |
replyTo | String | adres 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("[email protected]", "[email protected]", "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 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