Questa pagina è stata tradotta dall'API Cloud Translation.

Class GmailDraft

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

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 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 di questa bozza di messaggio.
`update(recipient, subject, body, options)`	`GmailDraft`	Sostituisce 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

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

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

GmailApp.createDraft(recipient, subject, body)

`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

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 separati 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 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)
`replyTo`	`String`	Un 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

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