Class GmailDraft

Bozza di Gmail

Un messaggio di bozza creato da un utente nell'account Gmail dell'utente.

Metodi

MetodoTipo restituitoBreve descrizione
deleteDraft()voidElimina questa bozza di messaggio.
getId()StringRecupera l'ID di questa bozza di messaggio.
getMessage()GmailMessageRestituisce un messaggio Gmail che rappresenta questa bozza.
getMessageId()StringRestituisce l'ID del GmailMessage che rappresenta questa bozza.
send()GmailMessageInvia questa bozza di 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 gli argomenti facoltativi.

Documentazione dettagliata

deleteDraft()

Elimina questa bozza di messaggio. 

const 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 o con gli ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getId()

Recupera l'ID di questa bozza di messaggio. 

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const draftId = draft.getId();
const 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 o con gli ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getMessage()

Restituisce un messaggio Gmail che rappresenta questa bozza. 

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

Invio

GmailMessage: il messaggio che rappresenta i contenuti di questa bozza

Autorizzazione

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

  • https://mail.google.com/

getMessageId()

Restituisce l'ID del GmailMessage che rappresenta questa bozza. 

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

Invio

String: l'ID messaggio

Autorizzazione

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

  • https://mail.google.com/

send()

Invia questa bozza di messaggio email. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota. 

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 o con gli ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

update(recipient, subject, body)

Sostituisce i contenuti di questa bozza di messaggio. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota. 

// The code below will update a draft email with the current date and time.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 appena aggiornata

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli 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 gli argomenti facoltativi. L'email può contenere testo normale o un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota. 

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 i 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 da inserire in Ccn
ccStringun elenco di indirizzi email separati da virgole da inserire in Cc
fromStringl'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
htmlBodyStringse 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
inlineImagesObjectun 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" />
nameStringil nome del mittente dell'email (valore predefinito: il nome dell'utente)
replyToStringUn indirizzo email da utilizzare come indirizzo di risposta predefinito (valore predefinito: l'indirizzo email dell'utente)

Invio

GmailDraft: la bozza appena aggiornata

Autorizzazione

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

  • https://mail.google.com/

Vedi anche