Questa pagina è stata tradotta dall'API Cloud Translation.

Class MailApp

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, options)

`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(message)

`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