Class GmailDraft

GmailDraft

Una bozza di messaggio creata dall'utente nel suo account Gmail.

Metodi

Metodo	Tipo restituito	Breve descrizione
deleteDraft()	void	Elimina questa bozza di messaggio.
getId()	String	Recupera l'ID di questa bozza di messaggio.
getMessage()	GmailMessage	Restituisce un oggetto GmailMessage che rappresenta questa bozza.
getMessageId()	String	Restituisce l'ID di GmailMessage che rappresenta questa bozza.
send()	GmailMessage	Invia questa bozza di email.
update(recipient, subject, body)	GmailDraft	Sostituisce i contenuti di questa bozza di messaggio.
update(recipient, subject, body, options)	GmailDraft	Sostituisce i contenuti di questa bozza di messaggio utilizzando 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 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(),
);

Indietro

String: l'ID bozza

Autorizzazione

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

• https://mail.google.com/

---

getMessage()

Restituisce un oggetto GmailMessage 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());

Indietro

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

• https://mail.google.com/

---

getMessageId()

Restituisce l'ID di 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());

Indietro

String: l'ID messaggio.

Autorizzazione

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

• https://mail.google.com/

---

send()

Invia questa bozza di 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

Indietro

GmailMessage: il messaggio appena inviato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o 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(
    '[e-mail]',
    'current time',
    `The time is: ${now.toString()}`,
);

Parametri

Nome	Tipo	Descrizione
recipient	String	Elenco di indirizzi email separati da virgole
subject	String	oggetto dell'email (massimo 250 caratteri)
body	String	corpo dell'email

Indietro

GmailDraft: la bozza appena aggiornata

Autorizzazione

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

• https://mail.google.com/

Vedi anche

• GmailApp.createDraft(recipient, subject, body)

---

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. 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(
    '[e-mail]',
    'Attachment example',
    'Please see attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

Parametri

Nome	Tipo	Descrizione
recipient	String	Elenco di indirizzi email separati da virgole
subject	String	oggetto dell'email (massimo 250 caratteri)
body	String	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
bcc	String	Un elenco di indirizzi email separato da virgole da inserire in Ccn
cc	String	un elenco di indirizzi email separati da virgole da inserire in Cc
from	String	l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
htmlBody	String	Se 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
inlineImages	Object	un 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" />
name	String	Il nome del mittente dell'email (impostazione predefinita: il nome dell'utente)
replyTo	String	un indirizzo email da utilizzare come Indirizzo per risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente)

Indietro

GmailDraft: la bozza appena aggiornata

Autorizzazione

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

• https://mail.google.com/

Vedi anche

• GmailApp.createDraft(recipient, subject, body, options)