Class GmailDraft

GmailDraft

Bozza di messaggio creata dall'utente nell'account Gmail di un utente.

Metodi

MetodoTipo restituitoBreve descrizione
deleteDraft()voidElimina la bozza del messaggio.
getId()StringRecupera l'ID di questa bozza di messaggio.
getMessage()GmailMessageRestituisce un messaggio Gmail che rappresenta questa bozza.
getMessageId()StringRestituisce l'ID dell'elemento GmailMessage che rappresenta questa bozza.
send()GmailMessageInvia la bozza di questo messaggio email.
update(recipient, subject, body)GmailDraftSostituisce i contenuti di questa bozza di messaggio.
update(recipient, subject, body, options)GmailDraftSostituisce i contenuti di questa bozza di messaggio utilizzando argomenti facoltativi.

Documentazione dettagliata

deleteDraft()

Elimina la bozza del messaggio.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage(); // Throws exception.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getId()

Recupera l'ID di questa bozza di messaggio.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var draftId = draft.getId();
var draftById = GmailApp.getDraft(draftId);
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Invio

String: l'ID bozza

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getMessage()

Restituisce un messaggio Gmail che rappresenta questa bozza.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var message = draft.getMessage();
Logger.log(message.getSubject());

Invio

GmailMessage: il messaggio che rappresenta i contenuti della bozza

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getMessageId()

Restituisce l'ID dell'elemento GmailMessage che rappresenta questa bozza.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var messageId = draft.getMessageId();
Logger.log(messageId == draft.getMessage().getId());

Invio

String: l'ID del messaggio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

send()

Invia la bozza di questo messaggio email. La dimensione delle email (incluse le intestazioni) è quota limitata.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var msg = draft.send(); // Send it
Logger.log(msg.getDate()); // Should be approximately the current timestamp

Invio

GmailMessage: il messaggio appena inviato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

update(recipient, subject, body)

Sostituisce i contenuti di questa bozza di messaggio. La dimensione delle email (incluse le intestazioni) è quota limitata.

// The code below will update a draft email with the current date and time.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var now = new Date();
draft.update("mike@example.com", "current time", "The time is: " + now.toString());

Parametri

NomeTipoDescrizione
recipientStringelenco di indirizzi email separati da virgole
subjectStringoggetto dell'email (massimo 250 caratteri)
bodyStringcorpo dell'email

Invio

GmailDraft: la bozza aggiornata di recente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

Vedi anche


update(recipient, subject, body, options)

Sostituisce i contenuti di questa bozza di messaggio utilizzando argomenti facoltativi. L'email può contenere testo normale o un corpo HTML. La dimensione delle email (incluse le intestazioni) è quota limitata.

// Update a draft email with a file from Google Drive attached as a PDF.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parametri

NomeTipoDescrizione
recipientStringelenco di indirizzi email separati da virgole
subjectStringoggetto dell'email (massimo 250 caratteri)
bodyStringcorpo 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
bccStringun elenco di indirizzi email separati da virgole in Ccn
ccStringun elenco di indirizzi email separati da virgole in Cc
fromStringl'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
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)
replyToStringUn indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)

Invio

GmailDraft: la bozza aggiornata di recente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

Vedi anche