Questa pagina è stata tradotta dall'API Cloud Translation.

Class GmailDraft

Una bozza di messaggio creata dall'utente nell'account Gmail di un utente.

Metodi

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

Ritorni

String: l'ID bozza

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'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());

Ritorni

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 dall'API REST correlata:

https://mail.google.com/

`getMessageId()`

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

Ritorni

String: l'ID del messaggio

Autorizzazione

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

https://mail.google.com/

`send()`

Invia questa bozza di messaggio email. La dimensione dell'email (incluse le intestazioni) è una 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

Ritorni

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 dall'API REST correlata:

https://mail.google.com/

`update(recipient, subject, body)`

Sostituisce i contenuti della bozza del messaggio. La dimensione dell'email (incluse le intestazioni) è una 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

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

Ritorni

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 dall'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 del messaggio utilizzando argomenti facoltativi. L'email può contenere testo normale o un corpo HTML. La dimensione dell'email (incluse le intestazioni) è una 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

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 specifichi 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 separato da virgole di indirizzi email in Ccn
`cc`	`String`	un elenco di indirizzi email da mettere in copia separati da virgole
`from`	`String`	l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da `GmailApp.getAliases()`
`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).
`replyTo`	`String`	Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente)

Ritorni

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 dall'API REST correlata:

https://mail.google.com/

Vedi anche

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