Class MailApp

MailApp

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

MetodoTipo restituitoBreve descrizione
getRemainingDailyQuota()IntegerRestituisce il numero di destinatari a cui puoi inviare email per il resto della giornata.
sendEmail(message)voidInvia un messaggio email.
sendEmail(recipient, subject, body)voidInvia un messaggio email.
sendEmail(recipient, subject, body, options)voidInvia un messaggio email con argomenti facoltativi.
sendEmail(to, replyTo, subject, body)voidInvia 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

NomeTipoDescrizione
messageObjectun oggetto JavaScript che rappresenta un messaggio email

Parametri avanzati

NomeTipoDescrizione
attachmentsBlobSource[]un array di file da inviare con l'email
bccStringun elenco di indirizzi email separati da virgole in Ccn
bodyStringil corpo dell'email
ccStringun elenco di indirizzi email separati da virgole in Cc
htmlBodyStringse 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
inlineImagesObjectun 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)
nameStringil nome del mittente dell'email. Il valore predefinito è quello del mittente nome utente.
noReplyBooleantrue 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.
replyToStringUn 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.
subjectStringl'oggetto dell'email
toStringl'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

NomeTipoDescrizione
recipientStringGli indirizzi dei destinatari, separati da virgole
subjectStringla riga dell'oggetto
bodyStringil 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

NomeTipoDescrizione
recipientStringGli indirizzi dei destinatari, separati da virgole
subjectStringla riga dell'oggetto
bodyStringil corpo dell'email
optionsObjectun oggetto JavaScript che specifica parametri avanzati, come elencato di seguito

Parametri avanzati

NomeTipoDescrizione
attachmentsBlobSource[]un array di file da inviare con l'email (vedi esempio)
bccStringun elenco di indirizzi email separati da virgole in Ccn
ccStringun elenco di indirizzi email separati da virgole in Cc
htmlBodyStringse 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
inlineImagesObjectun 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" />
nameStringil nome del mittente dell'email (impostazione predefinita: nome dell'utente)
noReplyBooleantrue 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.
replyToStringUn 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

NomeTipoDescrizione
toStringGli indirizzi dei destinatari, separati da virgole
replyToStringl'indirizzo per risposte
subjectStringla riga dell'oggetto
bodyStringil 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