Class GmailMessage

GmailMessage

Un messaggio nell'account Gmail di un utente.

Metodi

Metodo	Tipo restituito	Breve descrizione
createDraftReply(body)	GmailDraft	Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'indirizzo per risposte.
createDraftReply(body, options)	GmailDraft	Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'Indirizzo per risposte, con argomenti facoltativi.
createDraftReplyAll(body)	GmailDraft	Crea una bozza di messaggio di risposta al mittente utilizzando l'indirizzo per risposte e tutti i destinatari di questo messaggio.
createDraftReplyAll(body, options)	GmailDraft	Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'Indirizzo per risposte e tutti i destinatari, con argomenti facoltativi.
forward(recipient)	GmailMessage	Inoltra questo messaggio a nuovi destinatari.
forward(recipient, options)	GmailMessage	Inoltra questo messaggio a nuovi destinatari, con argomenti facoltativi.
getAttachments()	GmailAttachment[]	Recupera tutti gli allegati per questo messaggio.
getAttachments(options)	GmailAttachment[]	Recupera tutti gli allegati per questo messaggio.
getBcc()	String	Restituisce i destinatari separati da virgole in Ccn di questo messaggio.
getBody()	String	Recupera i contenuti HTML del corpo di questo messaggio.
getCc()	String	Restituisce i destinatari in Cc separati da virgole di questo messaggio.
getDate()	Date	Visualizza la data e l'ora di questo messaggio.
getFrom()	String	Recupera il mittente di questo messaggio.
getHeader(name)	String	Recupera il valore di un'intestazione RFC 2822 dato il nome dell'intestazione.
getId()	String	Recupera l'ID di questo messaggio.
getPlainBody()	String	Recupera i contenuti del corpo di questo messaggio senza formattazione HTML.
getRawContent()	String	Recupera i contenuti non elaborati di questo messaggio.
getReplyTo()	String	Recupera l'indirizzo per risposte di questo messaggio (di solito il mittente).
getSubject()	String	Recupera l'oggetto di questo messaggio.
getThread()	GmailThread	Recupera il thread che contiene questo messaggio.
getTo()	String	Recupera i destinatari separati da virgole di questo messaggio.
isDraft()	Boolean	Indica se questo messaggio è una bozza.
isInChats()	Boolean	Indica se questo messaggio è una chat.
isInInbox()	Boolean	Indica se il messaggio si trova nella posta in arrivo.
isInPriorityInbox()	Boolean	Restituisce true se il messaggio si trova nella posta in arrivo prioritaria, altrimenti restituisce false.
isInTrash()	Boolean	Indica se questo messaggio si trova nel cestino.
isStarred()	Boolean	Indica se il messaggio è stato aggiunto a Speciali.
isUnread()	Boolean	Indica se questo messaggio è da leggere.
markRead()	GmailMessage	Contrassegna il messaggio come letto.
markUnread()	GmailMessage	Contrassegna il messaggio come da leggere.
moveToTrash()	GmailMessage	Sposta il messaggio nel cestino.
refresh()	GmailMessage	Ricarica questo messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).
reply(body)	GmailMessage	Risposte al mittente di questo messaggio utilizzando l'Indirizzo per risposte.
reply(body, options)	GmailMessage	Risposte al mittente di questo messaggio utilizzando l'Indirizzo per risposte, con argomenti facoltativi.
replyAll(body)	GmailMessage	Risposte al mittente utilizzando l'Indirizzo per risposte e a tutti i destinatari di questo messaggio.
replyAll(body, options)	GmailMessage	Risposte al mittente di questo messaggio utilizzando l'indirizzo per risposte e tutti i destinatari, con argomenti facoltativi.
star()	GmailMessage	Aggiunge il messaggio a Speciali.
unstar()	GmailMessage	Rimuove il messaggio da Speciali.

Documentazione dettagliata

createDraftReply(body)

Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'indirizzo per risposte. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Create a draft reply to the original message with an acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReply('Got your message');

Parametri

Nome	Tipo	Descrizione
body	String	Il corpo dell'email.

Indietro

GmailDraft: il nuovo messaggio in bozza creato.

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

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReply(body, options)

Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'Indirizzo per risposte, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

Parametri

Nome	Tipo	Descrizione
body	String	Il 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 impostato, i dispositivi in grado di eseguire il rendering HTML lo utilizzano 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)
subject	String	Una nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Indietro

GmailDraft: il nuovo messaggio in bozza creato.

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

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body)

Crea una bozza di messaggio di risposta al mittente utilizzando l'indirizzo per risposte e tutti i destinatari di questo messaggio. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Create a draft response to all recipients (except those bcc'd) with an
// acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('Got your message');

Parametri

Nome	Tipo	Descrizione
body	String	Il corpo dell'email.

Indietro

GmailDraft: il nuovo messaggio in bozza creato.

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

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body, options)

Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'Indirizzo per risposte e tutti i destinatari, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Create a draft response to all recipients (except those bcc'd) using an HTML
// text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

Parametri

Nome	Tipo	Descrizione
body	String	Il 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 impostato, i dispositivi in grado di eseguire il rendering HTML lo utilizzano 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)
subject	String	Una nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Indietro

GmailDraft: il nuovo messaggio in bozza creato.

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

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

---

forward(recipient)

Inoltra questo messaggio a nuovi destinatari. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Forward first message of first inbox thread to recipient1 & recipient2,
// both @example.com
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.forward('[e-mail],[e-mail]');

Parametri

Nome	Tipo	Descrizione
recipient	String	Un elenco separato da virgole di indirizzi email.

Indietro

GmailMessage: questo messaggio è utile per la concatenazione.

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

• forward(recipient, options)

---

forward(recipient, options)

Inoltra questo messaggio a nuovi destinatari, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.forward('[e-mail],[e-mail]', {
  cc: '[e-mail]',
  bcc: '[e-mail],[e-mail]',
});

Parametri

Nome	Tipo	Descrizione
recipient	String	Un elenco separato da virgole di indirizzi 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 impostato, i dispositivi in grado di eseguire il rendering HTML lo utilizzano 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)
noReply	Boolean	true se l'email deve essere inviata da un indirizzo email generico no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è possibile solo per gli account Google Workspace, non per gli utenti Gmail
replyTo	String	un indirizzo email da utilizzare come Indirizzo per risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente)
subject	String	Una nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Indietro

GmailMessage: questo messaggio è utile per la concatenazione.

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

• forward(recipient)

---

getAttachments()

Recupera tutti gli allegati per questo messaggio.

Indietro

GmailAttachment[]: un array di allegati BLOB per questo 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/

---

getAttachments(options)

Recupera tutti gli allegati per questo messaggio.

Parametri

Nome	Tipo	Descrizione
options	Object	Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito.

Parametri avanzati

Nome	Tipo	Descrizione
includeInlineImages	Boolean	true se l'array restituito di allegati Blob deve includere immagini inline (il valore predefinito è true).
includeAttachments	Boolean	true se l'array restituito di allegati Blob deve includere allegati regolari (non incorporati) (il valore predefinito è true).

Indietro

GmailAttachment[]: un array di allegati BLOB per questo 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/

---

getBcc()

Restituisce i destinatari separati da virgole in Ccn di questo messaggio.

Per definizione, questo campo è vuoto per tutti i messaggi ricevuti.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getBcc());                      // Log bcc'd addresses

Indietro

String: i destinatari in Ccn separati da virgole di questo 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/

Vedi anche

• getTo()

---

getBody()

Recupera i contenuti HTML del corpo di questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getBody());                     // Log contents of the body

Indietro

String: i contenuti del corpo di questo 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/

Vedi anche

• getSubject()

---

getCc()

Restituisce i destinatari in Cc separati da virgole di questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getCc());                       // Log cc'd addresses

Indietro

String: i destinatari in Cc separati da virgole in questo 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/

Vedi anche

• getTo()

---

getDate()

Visualizza la data e l'ora di questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getDate());  // Log date and time of the message

Indietro

Date: la data e l'ora di questo 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/

---

getFrom()

Recupera il mittente di questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getFrom());  // Log from address of the message

Indietro

String: l'indirizzo email del mittente del 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/

Vedi anche

• getReplyTo()

---

getHeader(name)

Recupera il valore di un'intestazione RFC 2822 dato il nome dell'intestazione.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox.
const message = thread.getMessages()[0];           // Get the first message.
Logger.log(
    message.getHeader('Message-ID'));  // Logs the Message-ID RFC 2822 header.

Parametri

Nome	Tipo	Descrizione
name	String	Il nome dell'intestazione RFC, senza i due punti che la separano dal valore.

Indietro

String: il valore dell'intestazione o una stringa vuota se l'intestazione non esiste nel 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/

---

getId()

Recupera l'ID di questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
const id = message.getId();
const messageById = GmailApp.getMessageById(id);
Logger.log(
    message.getSubject() === messageById.getMessage());  // Always logs true

Indietro

String: l'ID messaggio.

---

getPlainBody()

Recupera i contenuti del corpo di questo messaggio senza formattazione HTML. Questa operazione è più complessa di getBody() e richiede più tempo.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getPlainBody());                // Log contents of the body

Indietro

String: il contenuto del corpo del messaggio in formato normale.

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

• getSubject()

---

getRawContent()

Recupera i contenuti non elaborati di questo messaggio. Equivale a "Mostra originale" nell'interfaccia utente di Gmail.

Indietro

String: i contenuti non elaborati di questo 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/

---

getReplyTo()

Recupera l'indirizzo per risposte di questo messaggio (di solito il mittente).

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getReplyTo());                  // Logs reply-to address

Indietro

String: l'indirizzo email per le risposte.

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

• getCc()

---

getSubject()

Recupera l'oggetto di questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getSubject());                  // Log subject line

Indietro

String: l'oggetto di questo 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/

Vedi anche

• getAttachments()

---

getThread()

Recupera il thread che contiene questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(
    message.getThread().getFirstMessageSubject() ===
        thread.getFirstMessageSubject(),
);  // Always logs true

Indietro

GmailThread: il GmailThread che contiene questo 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/

---

getTo()

Recupera i destinatari separati da virgole di questo messaggio.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getTo());  // Log the recipient of message

Indietro

String: i destinatari di questo messaggio separati da virgole.

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

• getCc()

---

isDraft()

Indica se questo messaggio è una bozza.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is draft? ${message.isDraft()}`);

Indietro

Boolean: indica se questo messaggio è una 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/

---

isInChats()

Indica se questo messaggio è una chat.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is a chat? ${message.isInChats()}`);

Indietro

Boolean: indica se questo messaggio è una chat.

---

isInInbox()

Indica se il messaggio si trova nella posta in arrivo.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in inbox? ${message.isInInbox()}`);

Indietro

Boolean: indica se il messaggio si trova nella posta in arrivo.

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/

---

isInPriorityInbox()

Restituisce true se il messaggio si trova nella posta in arrivo prioritaria, altrimenti restituisce false.

const thread = GmailApp.getPriorityInboxThreads(
    0, 1)[0];  // Get first thread in priority inbox
const messages = thread.getMessages();
for (let i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log(`is in priority inbox? ${messages[i].isInPriorityInbox()}`);
}

Indietro

Boolean: indica se il messaggio si trova nella posta prioritaria.

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/

---

isInTrash()

Indica se questo messaggio si trova nel cestino.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in the trash? ${message.isInTrash()}`);

Indietro

Boolean: indica se il messaggio si trova nel cestino.

---

isStarred()

Indica se il messaggio è stato aggiunto a Speciali.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is starred? ${message.isStarred()}`);

Indietro

Boolean: indica se il messaggio è stato aggiunto a Speciali.

---

isUnread()

Indica se questo messaggio è da leggere.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is unread? ${message.isUnread()}`);

Indietro

Boolean: lo stato Da leggere di questo 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/

---

markRead()

Contrassegna il messaggio come letto.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.markRead();                                // Mark as read

Indietro

GmailMessage: questo GmailMessage è utile per il concatenamento.

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

• isUnread()

---

markUnread()

Contrassegna il messaggio come da leggere.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.markUnread();                              // Mark as unread

Indietro

GmailMessage: questo GmailMessage è utile per il concatenamento.

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

• isUnread()

---

moveToTrash()

Sposta il messaggio nel cestino.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.moveToTrash();                             // Move message to trash

Indietro

GmailMessage: questo GmailMessage è utile per il concatenamento.

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

• isInTrash()

---

refresh()

Ricarica questo messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
// .. Do bunch of stuff here
message.refresh();  // Make sure it's up to date
// Do more stuff to message

Indietro

GmailMessage: questo messaggio per il concatenamento.

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/

---

reply(body)

Risposte al mittente di questo messaggio utilizzando l'Indirizzo per risposte. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Respond to author of message with acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.reply('Got your message');

Parametri

Nome	Tipo	Descrizione
body	String	Il corpo dell'email.

Indietro

GmailMessage: questo messaggio è utile per la concatenazione.

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

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

---

reply(body, options)

Risposte al mittente di questo messaggio utilizzando l'Indirizzo per risposte, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.reply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  noReply: true,
});

Parametri

Nome	Tipo	Descrizione
body	String	Il 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 impostato, i dispositivi in grado di eseguire il rendering HTML lo utilizzano 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)
noReply	Boolean	true se l'email deve essere inviata da un indirizzo email generico no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è possibile solo per gli account Google Workspace, non per gli utenti Gmail
replyTo	String	un indirizzo email da utilizzare come Indirizzo per risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente)
subject	String	Una nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Indietro

GmailMessage: questo messaggio è utile per la concatenazione.

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

• reply(body)
• replyAll(body)
• replyAll(body, options)

---

replyAll(body)

Risposte al mittente utilizzando l'Indirizzo per risposte e a tutti i destinatari di questo messaggio. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Respond to all recipients (except bcc'd) of last email in thread with
// acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.replyAll('Got your message');

Parametri

Nome	Tipo	Descrizione
body	String	Il corpo dell'email.

Indietro

GmailMessage: questo messaggio è utile per la concatenazione.

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

• reply(body)
• reply(body, options)
• replyAll(body, options)

---

replyAll(body, options)

Risposte al mittente di questo messaggio utilizzando l'indirizzo per risposte e tutti i destinatari, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla quota.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.replyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  noReply: true,
});

Parametri

Nome	Tipo	Descrizione
body	String	Il 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 impostato, i dispositivi in grado di eseguire il rendering HTML lo utilizzano 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)
noReply	Boolean	true se l'email deve essere inviata da un indirizzo email generico no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è possibile solo per gli account Google Workspace, non per gli utenti Gmail
replyTo	String	un indirizzo email da utilizzare come Indirizzo per risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente)
subject	String	Una nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Indietro

GmailMessage: questo messaggio è utile per la concatenazione.

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

• reply(body)
• reply(body, options)
• replyAll(body)

---

star()

Aggiunge il messaggio a Speciali.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.star();                                    // Star the message

Indietro

GmailMessage: questo GmailMessage è utile per il concatenamento.

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

• unstar()

---

unstar()

Rimuove il messaggio da Speciali.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.unstar();                                  // Unstar the message

Indietro

GmailMessage: questo GmailMessage è utile per il concatenamento.

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

• star()