Class GmailMessage

MessaggioGmail

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 le risposte.
createDraftReply(body, options)	GmailDraft	Crea una bozza di messaggio che risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta, con argomenti facoltativi.
createDraftReplyAll(body)	GmailDraft	Crea una bozza di messaggio di risposta al mittente utilizzando l'indirizzo di risposta e tutti i destinatari di questo messaggio.
createDraftReplyAll(body, options)	GmailDraft	Crea una bozza di messaggio che risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta 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 di questo messaggio.
getAttachments(options)	GmailAttachment[]	Recupera tutti gli allegati di questo messaggio.
getBcc()	String	Recupera i destinatari in Ccn separati da virgola in questo messaggio.
getBody()	String	Recupera il contenuto HTML del corpo di questo messaggio.
getCc()	String	Recupera i destinatari in Cc separati da virgola di questo messaggio.
getDate()	Date	Recupera la data e l'ora di questo messaggio.
getFrom()	String	Recupera il mittente di questo messaggio.
getHeader(name)	String	Restituisce il valore di un'intestazione RFC 2822 in base al nome dell'intestazione.
getId()	String	Recupera l'ID di questo messaggio.
getPlainBody()	String	Recupera il contenuto del corpo del 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 di questo messaggio separati da virgola.
isDraft()	Boolean	Indica se questo messaggio è una bozza.
isInChats()	Boolean	Indica se questo messaggio è una chat.
isInInbox()	Boolean	Indica se il messaggio è nella Posta in arrivo.
isInPriorityInbox()	Boolean	Restituisce true se il messaggio si trova nella Posta in arrivo prioritaria; restituisce false in caso contrario.
isInTrash()	Boolean	Indica se il messaggio si trova nel cestino.
isStarred()	Boolean	Restituisce se questo messaggio è stato aggiunto a Speciali.
isUnread()	Boolean	Indica se il 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 e così via siano cambiati).
reply(body)	GmailMessage	Risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta.
reply(body, options)	GmailMessage	Risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta, con argomenti facoltativi.
replyAll(body)	GmailMessage	Risponde al mittente utilizzando l'indirizzo di risposta e tutti i destinatari di questo messaggio.
replyAll(body, options)	GmailMessage	Risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta e tutti i destinatari, con argomenti facoltativi.
star()	GmailMessage	Il messaggio viene aggiunto a Speciali.
unstar()	GmailMessage	Il messaggio viene rimosso dalla sezione Speciali.

Documentazione dettagliata

createDraftReply(body)

Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'indirizzo per le 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.

Invio

GmailDraft: il messaggio della bozza appena creato.

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

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

---

createDraftReply(body, options)

Crea una bozza di messaggio che risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) sono in misura limitata.

// 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 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 utilizzano al posto dell'argomento body obbligatorio; puoi aggiungere un campo inlineImages facoltativo 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)
subject	String	Una nuova riga dell'oggetto per l'email, con un massimo di 250 caratteri.

Invio

GmailDraft: il messaggio della bozza appena creato.

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

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

---

createDraftReplyAll(body)

Crea una bozza di messaggio di risposta al mittente utilizzando l'indirizzo di risposta 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.

Invio

GmailDraft: il messaggio della bozza appena creato.

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

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

---

createDraftReplyAll(body, options)

Crea una bozza di messaggio che risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta 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 in misura limitata.

// 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 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 utilizzano al posto dell'argomento body obbligatorio; puoi aggiungere un campo inlineImages facoltativo 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)
subject	String	Una nuova riga dell'oggetto per l'email, con un massimo di 250 caratteri.

Invio

GmailDraft: il messaggio della bozza appena creato.

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

• 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 di indirizzi email separati da virgole.

Invio

GmailMessage: questo messaggio è utile per l'accodamento.

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

• 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 in quota limitata.

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 di indirizzi email separati da virgole.
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 utilizzano al posto dell'argomento body obbligatorio; puoi aggiungere un campo inlineImages facoltativo 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)
noReply	Boolean	true se l'email deve essere inviata da un indirizzo email generico senza risposta per scoraggiare i destinatari a 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 di risposta predefinito (valore predefinito: l'indirizzo email dell'utente)
subject	String	Una nuova riga dell'oggetto per l'email, con un massimo di 250 caratteri.

Invio

GmailMessage: questo messaggio è utile per l'accodamento.

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

• forward(recipient)

---

getAttachments()

Recupera tutti gli allegati di questo messaggio.

Invio

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

• https://mail.google.com/

---

getAttachments(options)

Recupera tutti gli allegati di 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 le immagini incorporate (il valore predefinito è true).
includeAttachments	Boolean	true se l'array di allegati Blob restituito deve includere gli allegati regolari (non in linea) (il valore predefinito è true).

Invio

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

• https://mail.google.com/

---

getBcc()

Recupera i destinatari in Ccn separati da virgola in questo messaggio.

Per impostazione predefinita, questo valore è 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

Invio

String: i destinatari in Ccn di questo messaggio separati da virgole.

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

• getTo()

---

getBody()

Recupera il contenuto 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

Invio

String: il contenuto del corpo di questo 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/

Vedi anche

• getSubject()

---

getCc()

Recupera i destinatari in Cc separati da virgola 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

Invio

String: i destinatari in Cc di questo messaggio separati da virgole.

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

• getTo()

---

getDate()

Recupera 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

Invio

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 con gli 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

Invio

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

• https://mail.google.com/

Vedi anche

• getReplyTo()

---

getHeader(name)

Restituisce il valore di un'intestazione RFC 2822 in base al 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.

Invio

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 con gli 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

Invio

String: l'ID messaggio.

---

getPlainBody()

Recupera il contenuto del corpo del 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

Invio

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

Vedi anche

• getSubject()

---

getRawContent()

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

Invio

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 con gli 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

Invio

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 con gli 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

Invio

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

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

Invio

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

---

getTo()

Recupera i destinatari di questo messaggio separati da virgola.

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

Invio

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 con gli 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()}`);

Invio

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

---

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()}`);

Invio

Boolean: indica se il messaggio è una chat.

---

isInInbox()

Indica se il messaggio è 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()}`);

Invio

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

• https://mail.google.com/

---

isInPriorityInbox()

Restituisce true se il messaggio si trova nella Posta in arrivo prioritaria; restituisce false in caso contrario.

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()}`);
}

Invio

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

• https://mail.google.com/

---

isInTrash()

Indica se il 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()}`);

Invio

Boolean: indica se il messaggio si trova nel cestino.

---

isStarred()

Restituisce se questo 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()}`);

Invio

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

---

isUnread()

Indica se il 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()}`);

Invio

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 con gli 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

Invio

GmailMessage: questo messaggio Gmail, utile per l'accodamento.

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

• 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

Invio

GmailMessage: questo messaggio Gmail, utile per l'accodamento.

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

• 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

Invio

GmailMessage: questo messaggio Gmail, utile per l'accodamento.

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

• isInTrash()

---

refresh()

Ricarica questo messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via 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

Invio

GmailMessage: questo messaggio per l'accodamento.

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/

---

reply(body)

Risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta. Le dimensioni dell'email (incluse le intestazioni) sono in misura limitata.

// 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.

Invio

GmailMessage: questo messaggio è utile per l'accodamento.

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

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

---

reply(body, options)

Risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (incluse le intestazioni) superano la quota limitata.

// 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 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 utilizzano al posto dell'argomento body obbligatorio; puoi aggiungere un campo inlineImages facoltativo 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)
noReply	Boolean	true se l'email deve essere inviata da un indirizzo email generico senza risposta per scoraggiare i destinatari a 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 di risposta predefinito (valore predefinito: l'indirizzo email dell'utente)
subject	String	Una nuova riga dell'oggetto per l'email, con un massimo di 250 caratteri.

Invio

GmailMessage: questo messaggio è utile per l'accodamento.

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

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

---

replyAll(body)

Risponde al mittente utilizzando l'indirizzo di risposta e tutti i destinatari di questo messaggio. Le dimensioni dell'email (incluse le intestazioni) sono limitate.

// 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.

Invio

GmailMessage: questo messaggio è utile per l'accodamento.

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

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

---

replyAll(body, options)

Risponde al mittente di questo messaggio utilizzando l'indirizzo di risposta 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) superano la quota limitata.

// 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 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 utilizzano al posto dell'argomento body obbligatorio; puoi aggiungere un campo inlineImages facoltativo 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)
noReply	Boolean	true se l'email deve essere inviata da un indirizzo email generico senza risposta per scoraggiare i destinatari a 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 di risposta predefinito (valore predefinito: l'indirizzo email dell'utente)
subject	String	Una nuova riga dell'oggetto per l'email, con un massimo di 250 caratteri.

Invio

GmailMessage: questo messaggio è utile per l'accodamento.

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

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

---

star()

Il messaggio viene aggiunto 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

Invio

GmailMessage: questo messaggio Gmail, utile per l'accodamento.

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

• unstar()

---

unstar()

Il messaggio viene rimosso dalla sezione 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

Invio

GmailMessage: questo messaggio Gmail, utile per l'accodamento.

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

• star()