Class MailApp

MailApp

Invia email.

Questo servizio consente agli utenti di inviare email con il controllo completo sul contenuto. A differenza di GmailApp, MailApp ha il solo scopo di inviare email. MailApp non può accedere alla casella di posta in arrivo di Gmail di un utente.

È più probabile che le modifiche agli script scritti utilizzando GmailApp attivino una richiesta di riautorizzazione da parte di 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. Il valore restituito è valido per l'esecuzione corrente e potrebbe variare tra le esecuzioni.

Le quote si basano sul numero di destinatari email. Per informazioni specifiche sulle quote, vedi Quote per i servizi Google. 

const emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);

Indietro

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 e consente molte più opzioni. 

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  const googleLogoUrl =
      'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png';
  const youtubeLogoUrl =
      'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png';
  const googleLogoBlob =
      UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob');
  const 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 separato da virgole da inserire in Ccn
bodyStringil corpo dell'email
ccStringun elenco di indirizzi email separati da virgole da inserire in Cc
htmlBodyStringSe impostati, i dispositivi in grado di eseguire il rendering di HTML lo utilizzeranno al posto dell'argomento body obbligatorio. Puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se hai incorporato immagini per la tua email
inlineImagesObjectun oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String) ai dati dell'immagine (BlobSource); ciò presuppone che il parametro htmlBody venga utilizzato e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> (vedi esempio)
nameStringil nome del mittente dell'email. Il valore predefinito è il nome utente del mittente.
noReplyBooleantrue se l'email deve essere inviata da un indirizzo email generico 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 per risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente). Se noReply è impostato su true, replyTo viene ignorato.
subjectStringl'oggetto dell'email
toStringl'indirizzo email del destinatario o un elenco di indirizzi email separati da virgole che saranno i 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.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 i 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 separato da virgole da inserire in Ccn
ccStringun elenco di indirizzi email separati da virgole da inserire in Cc
htmlBodyStringSe impostati, i dispositivi in grado di eseguire il rendering di HTML lo utilizzeranno al posto dell'argomento body obbligatorio. Puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se hai incorporato immagini per la tua email
inlineImagesObjectun oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String) ai dati dell'immagine (BlobSource); ciò presuppone che il parametro htmlBody venga utilizzato e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" />
nameStringIl nome del mittente dell'email (impostazione predefinita: il nome dell'utente)
noReplyBooleantrue se l'email deve essere inviata da un indirizzo email generico 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 per 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

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