Invia email.
Questo servizio consente agli utenti di inviare email con il controllo completo sui contenuti delle email. A differenza di GmailApp, l'unico scopo di MailApp è inviare email. MailApp non può accedere alla Posta in arrivo di Gmail di un utente.
È più probabile che le modifiche agli script scritti utilizzando GmailApp attivino una richiesta di nuova autorizzazione da parte di 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. Il valore restituito è valido per l'esecuzione corrente e potrebbe variare tra un'esecuzione e l'altra.
Le quote si basano sul numero di destinatari dell'email. Per informazioni specifiche sulle quote, consulta Quote per i servizi Google.
var emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log("Remaining email quota: " + emailQuotaRemaining);
Ritorni
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 è molto più flessibile e offre molte più 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 separato da virgole di indirizzi email in Ccn |
body | String | il corpo dell'email |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
htmlBody | String | se impostato, i dispositivi in grado di visualizzare il codice HTML lo utilizzeranno al posto dell'argomento corpo richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo 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 è il nome utente del mittente. |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo email generico non abilitato alle risposte per scoraggiare i destinatari dal rispondere alle email. Questa opzione è disponibile solo per gli account Google Workspace, non per gli utenti di Gmail. |
replyTo | String | un indirizzo email da utilizzare come indirizzo per le risposte predefinito (valore predefinito: l'indirizzo email dell'utente). Se il criterio noReply viene impostato su true , replyTo viene ignorato. |
subject | String | l'oggetto dell'email |
to | String | L'indirizzo email del destinatario o un elenco separato da virgole di 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 specifichi 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 separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
htmlBody | String | se impostato, i dispositivi in grado di visualizzare il codice HTML lo utilizzeranno al posto dell'argomento corpo richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo 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: il nome dell'utente). |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo email generico non abilitato alle risposte per scoraggiare i destinatari dal rispondere alle email. Questa opzione è disponibile solo per gli account Google Workspace, non per gli utenti di Gmail. |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: 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 il 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 | 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