Questa pagina è stata tradotta dall'API Cloud Translation.

Class MailApp

Invia email.

Questo servizio consente agli utenti di inviare email con il controllo completo dei contenuti. A differenza di GmailApp, lo scopo esclusivo di MailApp è l'invio di email. MailApp non può accedere alla Posta in arrivo di Gmail di un utente.

Le modifiche agli script scritti utilizzando GmailApp hanno maggiori probabilità di attivare 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 da un'esecuzione all'altra.

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

const 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 e consente molte altre 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

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 da inserire in Ccn
`body`	`String`	il corpo dell'email
`cc`	`String`	un elenco di indirizzi email separati da virgole da inserire in Cc
`htmlBody`	`String`	se impostato, i dispositivi in grado di eseguire il rendering dell'HTML lo utilizzeranno al posto dell'argomento obbligatorio del corpo. Puoi aggiungere un campo facoltativo `inlineImages` nel corpo HTML se hai incorporato immagini per l'email
`inlineImages`	`Object`	un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (`String`) ai dati dell'immagine (`BlobSource`); si presume che venga utilizzato il parametro `htmlBody` e che contenga riferimenti a queste immagini nel formato `<img src="cid:imageKey" />` (vedi esempio)
`name`	`String`	il nome del mittente dell'email. L'impostazione predefinita è il nome utente del mittente.
`noReply`	`Boolean`	`true` se l'email deve essere inviata da un indirizzo email generico senza risposta per scoraggiare i destinatari a 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 di risposta predefinito (valore predefinito: l'indirizzo email dell'utente). Se `noReply` è impostato su `true`, `replyTo` viene ignorato.
`subject`	`String`	l'oggetto dell'email
`to`	`String`	l'indirizzo email del destinatario o un elenco di indirizzi email separati da virgole da inserire come 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.
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

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 i 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 da inserire in Ccn
`cc`	`String`	un elenco di indirizzi email separati da virgole da inserire in Cc
`htmlBody`	`String`	se impostato, i dispositivi in grado di eseguire il rendering dell'HTML lo utilizzeranno al posto dell'argomento obbligatorio del corpo. Puoi aggiungere un campo facoltativo `inlineImages` nel corpo HTML se hai incorporato immagini per l'email
`inlineImages`	`Object`	un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (`String`) ai dati dell'immagine (`BlobSource`); si presume che venga utilizzato il parametro `htmlBody` e che contenga riferimenti a queste immagini nel formato `<img src="cid:imageKey" />`
`name`	`String`	il nome del mittente dell'email (valore predefinito: il nome dell'utente)
`noReply`	`Boolean`	`true` se l'email deve essere inviata da un indirizzo email generico senza risposta per scoraggiare i destinatari a 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 di risposta predefinito (valore 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(message)

`sendEmail(to, replyTo, subject, body)`

Invia un messaggio email. Questo metodo consente a un utente di specificare facilmente un indirizzo di risposta per il messaggio inviato che può essere diverso da quello del 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 le 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