Invia le email.
Questo servizio consente agli utenti di inviare email con il controllo completo dei contenuti delle email. A differenza di GmailApp, l'unico scopo di MailApp è l'invio di email. MailApp non può accedere a Gmail di un utente posta in arrivo.
È più probabile che le modifiche agli script scritti utilizzando GmailApp attivino una nuova autorizzazione a un utente rispetto agli script MailApp.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getRemainingDailyQuota() | Integer | Restituisce il numero di destinatari a cui puoi inviare email per il resto della giornata. |
sendEmail(message) | void | Invia un messaggio email. |
sendEmail(recipient, subject, body) | void | Invia un messaggio email. |
sendEmail(recipient, subject, body, options) | void | Invia un messaggio email con argomenti facoltativi. |
sendEmail(to, replyTo, subject, body) | void | Invia un messaggio email. |
Documentazione dettagliata
getRemainingDailyQuota()
Restituisce il numero di destinatari a cui puoi inviare email per il resto della giornata. L'oggetto restituito è valido per l'esecuzione corrente e può variare da un'esecuzione all'altra.
Le quote si basano sul numero di destinatari email. Per informazioni specifiche sulla quota, consulta Quote per Servizi.
var emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log("Remaining email quota: " + emailQuotaRemaining);
Invio
Integer
: il numero di email rimanenti che lo script può inviare.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(message)
Invia un messaggio email. Questa variante del metodo è molto più flessibile, poiché consente altre opzioni.
// 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 } }); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
message | Object | un oggetto JavaScript che rappresenta un messaggio email |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
attachments | BlobSource[] | un array di file da inviare con l'email |
bcc | String | un elenco di indirizzi email separati da virgole in Ccn |
body | String | il corpo dell'email |
cc | String | un elenco di indirizzi email separati da virgole in Cc |
htmlBody | String | se impostato, verrà usato dai dispositivi in grado di eseguire il rendering dell'HTML
dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel codice HTML
corpo se hai immagini incorporate per la tua email |
inlineImages | Object | un oggetto JavaScript contenente un mapping dalla chiave immagine
(String ) ai dati dell'immagine (BlobSource ); presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> (vedi esempio) |
name | String | il nome del mittente dell'email. Il valore predefinito è quello del mittente nome utente. |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo generico
indirizzo email no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è
possibile solo per gli account Google Workspace, non per gli utenti Gmail. |
replyTo | String | Un indirizzo email da utilizzare come indirizzo predefinito per le risposte
(predefinito: l'indirizzo email dell'utente). Se il criterio noReply viene impostato su true , il criterio replyTo viene ignorato. |
subject | String | l'oggetto dell'email |
to | String | l'indirizzo email del destinatario o un elenco separato da virgole gli indirizzi email dei destinatari |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.send_mail
Vedi anche
sendEmail(recipient, subject, body)
Invia un messaggio email.
MailApp.sendEmail("recipient@example.com", "TPS reports", "Where are the TPS reports?");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
recipient | String | Gli indirizzi dei destinatari, separati da virgole |
subject | String | la riga dell'oggetto |
body | String | il corpo dell'email |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body, options)
Invia un messaggio email con argomenti facoltativi.
// 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] });
Parametri
Nome | Tipo | Descrizione |
---|---|---|
recipient | String | Gli indirizzi dei destinatari, separati da virgole |
subject | String | la riga dell'oggetto |
body | String | il corpo dell'email |
options | Object | un oggetto JavaScript che specifica parametri avanzati, come elencato di seguito |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
attachments | BlobSource[] | un array di file da inviare con l'email (vedi esempio) |
bcc | String | un elenco di indirizzi email separati da virgole in Ccn |
cc | String | un elenco di indirizzi email separati da virgole in Cc |
htmlBody | String | se impostato, verrà usato dai dispositivi in grado di eseguire il rendering dell'HTML
dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel codice HTML
corpo se hai immagini incorporate per la tua email |
inlineImages | Object | un oggetto JavaScript contenente un mapping dalla chiave immagine
(String ) ai dati dell'immagine (BlobSource ); presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> |
name | String | il nome del mittente dell'email (impostazione predefinita: nome dell'utente) |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo generico
indirizzo email no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è
possibile solo per gli account Google Workspace, non per gli utenti Gmail. |
replyTo | String | Un indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente) |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.send_mail
Vedi anche
sendEmail(to, replyTo, subject, body)
Invia un messaggio email. Questo metodo consente a un utente di specificare facilmente un indirizzo per risposte per messaggio inviato che può essere diverso dal mittente.
MailApp.sendEmail("recipient@example.com", "replies@example.com", "TPS report status", "What is the status of those TPS reports?");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
to | String | Gli indirizzi dei destinatari, separati da virgole |
replyTo | String | l'indirizzo per risposte |
subject | String | la riga dell'oggetto |
body | String | il corpo dell'email in testo normale |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.send_mail