Class GmailMessage

GmailMessage

Un messaggio nell'account Gmail di un utente.

Metodi

MetodoTipo restituitoBreve descrizione
createDraftReply(body)GmailDraftCrea una bozza di messaggio rispondendo al mittente di questo messaggio utilizzando l'indirizzo per risposte.
createDraftReply(body, options)GmailDraftCrea una bozza di messaggio rispondendo al mittente utilizzando l'indirizzo per risposte, con argomenti facoltativi.
createDraftReplyAll(body)GmailDraftCrea una bozza di messaggio rispondendo al mittente utilizzando l'indirizzo per risposte e tutti i destinatari del questo messaggio.
createDraftReplyAll(body, options)GmailDraftCrea una bozza di messaggio rispondendo al mittente di questo messaggio utilizzando l'indirizzo per risposte e tutti i destinatari, con argomenti facoltativi.
forward(recipient)GmailMessageInoltra il messaggio a nuovi destinatari.
forward(recipient, options)GmailMessageInoltra 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()StringRestituisce i destinatari separati da virgole in Ccn di questo messaggio.
getBody()StringRecupera i contenuti HTML del corpo di questo messaggio.
getCc()StringRestituisce i destinatari separati da virgole in Cc di questo messaggio.
getDate()DateRecupera la data e l'ora di questo messaggio.
getFrom()StringRecupera il mittente di questo messaggio.
getHeader(name)StringRestituisce il valore di un'intestazione RFC 2822 dato il nome dell'intestazione.
getId()StringRecupera l'ID di questo messaggio.
getPlainBody()StringRecupera i contenuti del corpo del messaggio senza formattazione HTML.
getRawContent()StringRecupera i contenuti non elaborati di questo messaggio.
getReplyTo()StringRecupera l'indirizzo per risposte del messaggio (di solito il mittente).
getSubject()StringRecupera l'oggetto di questo messaggio.
getThread()GmailThreadRecupera il thread che contiene il messaggio.
getTo()StringRestituisce i destinatari del messaggio separati da virgole.
isDraft()BooleanRiconosce se il messaggio è una bozza.
isInChats()BooleanRiconosce se il messaggio è una chat.
isInInbox()BooleanRiconosce se il messaggio si trova nella posta in arrivo.
isInPriorityInbox()BooleanRestituisce true se il messaggio si trova nella Posta in arrivo prioritaria; restituisce false in caso contrario.
isInTrash()BooleanRiconosce se il messaggio si trova nel cestino.
isStarred()BooleanRiconosce se il messaggio è stato aggiunto a Speciali.
isUnread()BooleanRiconosce se il messaggio è da leggere.
markRead()GmailMessageContrassegna il messaggio come letto.
markUnread()GmailMessageContrassegna il messaggio come da leggere.
moveToTrash()GmailMessageSposta il messaggio nel cestino.
refresh()GmailMessageRicarica questo messaggio e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).
reply(body)GmailMessageRisponde al mittente di questo messaggio utilizzando l'indirizzo per risposte.
reply(body, options)GmailMessageRisposte al mittente di questo messaggio utilizzando l'indirizzo per le risposte, con argomenti facoltativi.
replyAll(body)GmailMessageRisponde al mittente utilizzando l'indirizzo per risposte e a tutti i destinatari del messaggio.
replyAll(body, options)GmailMessageRisponde al mittente di questo messaggio utilizzando l'indirizzo per risposte e a tutti i destinatari, con argomenti facoltativi.
star()GmailMessageAggiungi il messaggio a Speciali.
unstar()GmailMessageRimuove il messaggio da Speciali.

Documentazione dettagliata

createDraftReply(body)

Crea una bozza di messaggio rispondendo al mittente di questo messaggio utilizzando l'indirizzo per risposte. La la dimensione delle email (incluse le intestazioni) è quota limitata.

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

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.

Invio

GmailDraft: la bozza del messaggio appena creata.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


createDraftReply(body, options)

Crea una bozza di messaggio rispondendo al mittente utilizzando l'indirizzo per risposte, con argomenti facoltativi.

L'email può contenere sia testo normale sia un corpo HTML. Le dimensioni dell'email (inclusi intestazioni) è quota limitata.

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.
optionsObjectUn oggetto JavaScript che specifica parametri avanzati, come elencato di seguito.

Parametri avanzati

NomeTipoDescrizione
attachmentsBlobSource[]un array di file da inviare con l'email
bccStringun elenco di indirizzi email separati da virgole in Ccn
ccStringun elenco di indirizzi email separati da virgole in Cc
fromStringl'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
htmlBodyStringse impostato, i dispositivi in grado di eseguire il rendering dell'HTML lo utilizzano anziché l'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se hai immagini incorporate per le tue email
inlineImagesObjectun oggetto JavaScript contenente un mapping dalla chiave immagine (String) ai dati dell'immagine (BlobSource); presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" />
nameStringil nome del mittente dell'email (impostazione predefinita: nome dell'utente)
replyToStringUn indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)
subjectStringUna nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Invio

GmailDraft: la bozza del messaggio appena creata.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


createDraftReplyAll(body)

Crea una bozza di messaggio rispondendo al mittente utilizzando l'indirizzo per risposte e tutti i destinatari del questo messaggio. La dimensione delle email (incluse le intestazioni) è quota limitata.

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

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.

Invio

GmailDraft: la bozza del messaggio appena creata.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


createDraftReplyAll(body, options)

Crea una bozza di messaggio rispondendo 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 (inclusi intestazioni) è quota limitata.

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

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.
optionsObjectUn oggetto JavaScript che specifica parametri avanzati, come elencato di seguito.

Parametri avanzati

NomeTipoDescrizione
attachmentsBlobSource[]un array di file da inviare con l'email
bccStringun elenco di indirizzi email separati da virgole in Ccn
ccStringun elenco di indirizzi email separati da virgole in Cc
fromStringl'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
htmlBodyStringse impostato, i dispositivi in grado di eseguire il rendering dell'HTML lo utilizzano anziché l'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se hai immagini incorporate per le tue email
inlineImagesObjectun oggetto JavaScript contenente un mapping dalla chiave immagine (String) ai dati dell'immagine (BlobSource); presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" />
nameStringil nome del mittente dell'email (impostazione predefinita: nome dell'utente)
replyToStringUn indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)
subjectStringUna nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Invio

GmailDraft: la bozza del messaggio appena creata.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


forward(recipient)

Inoltra il messaggio a nuovi destinatari. La dimensione delle email (incluse le intestazioni) è quota limitata.

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

Parametri

NomeTipoDescrizione
recipientStringUn elenco di indirizzi email separati da virgole.

Invio

GmailMessage : questo messaggio, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


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) è quota limitata.

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com", {
  cc: "myboss@example.com",
  bcc: "mybosses-boss@example.com,vp@example.com"
});

Parametri

NomeTipoDescrizione
recipientStringUn elenco di indirizzi email separati da virgole.
optionsObjectUn oggetto JavaScript che specifica parametri avanzati, come elencato di seguito.

Parametri avanzati

NomeTipoDescrizione
attachmentsBlobSource[]un array di file da inviare con l'email
bccStringun elenco di indirizzi email separati da virgole in Ccn
ccStringun elenco di indirizzi email separati da virgole in Cc
fromStringl'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
htmlBodyStringse impostato, i dispositivi in grado di eseguire il rendering dell'HTML lo utilizzano anziché l'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se hai immagini incorporate per le tue email
inlineImagesObjectun oggetto JavaScript contenente un mapping dalla chiave immagine (String) ai dati dell'immagine (BlobSource); presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" />
nameStringil nome del mittente dell'email (impostazione predefinita: nome dell'utente)
noReplyBooleantrue se l'email deve essere inviata da un indirizzo generico indirizzo email no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è possibile solo per gli account Google Workspace, non per gli utenti Gmail.
replyToStringUn indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)
subjectStringUna nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Invio

GmailMessage : questo messaggio, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


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

  • https://mail.google.com/

getAttachments(options)

Recupera tutti gli allegati di questo messaggio.

Parametri

NomeTipoDescrizione
optionsObjectUn oggetto JavaScript che specifica parametri avanzati, come elencato di seguito.

Parametri avanzati

NomeTipoDescrizione
includeInlineImagesBooleantrue se l'array di Blob restituito gli allegati devono includere immagini in linea (il valore predefinito è true).
includeAttachmentsBooleantrue se l'array di Blob restituito gli allegati devono includere allegati normali (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 oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getBcc()

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

Questo campo è vuoto per tutti i messaggi ricevuti, per definizione.

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

Invio

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

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


getBody()

Recupera i contenuti HTML del corpo di questo messaggio.

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

Invio

String: i contenuti del corpo del messaggio.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


getCc()

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

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

Invio

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

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


getDate()

Recupera la data e l'ora di questo messaggio.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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 oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getFrom()

Recupera il mittente di questo messaggio.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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 oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

Vedi anche


getHeader(name)

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

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

Parametri

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

  • https://mail.google.com/

getId()

Recupera l'ID di questo messaggio.

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

Invio

String: l'ID del messaggio.


getPlainBody()

Recupera i contenuti del corpo del messaggio senza formattazione HTML. Questo è più complesso di getBody() e richiede più tempo.

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

Invio

String: i contenuti del corpo del messaggio.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


getRawContent()

Recupera i contenuti non elaborati di questo messaggio. Equivale 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 oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

getReplyTo()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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 oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

Vedi anche


getSubject()

Recupera l'oggetto di questo messaggio.

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

Invio

String: l'oggetto del messaggio.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


getThread()

Recupera il thread che contiene il messaggio.

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

Invio

GmailThread: il thread di Gmail che contiene questo messaggio.

Autorizzazione

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

  • https://mail.google.com/

getTo()

Restituisce i destinatari del messaggio separati da virgole.

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

Invio

String: i destinatari del messaggio, separati da virgole.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


isDraft()

Riconosce se il messaggio è una bozza.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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 oppure ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

isInChats()

Riconosce se il messaggio è una chat.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

Invio

Boolean: se questo messaggio è una chat.


isInInbox()

Riconosce se il messaggio si trova nella posta in arrivo.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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 oppure 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.

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var 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 in arrivo prioritaria.

Autorizzazione

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

  • https://mail.google.com/

isInTrash()

Riconosce se il messaggio si trova nel cestino.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

Invio

Boolean: indica se il messaggio è nel cestino.


isStarred()

Riconosce se il messaggio è stato aggiunto a Speciali.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

Invio

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


isUnread()

Riconosce se il messaggio è da leggere.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

Invio

Boolean: lo stato da leggere del messaggio.

Autorizzazione

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

  • https://mail.google.com/

markRead()

Contrassegna il messaggio come letto.

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

Invio

GmailMessage: questo messaggio di Gmail, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


markUnread()

Contrassegna il messaggio come da leggere.

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

Invio

GmailMessage: questo messaggio di Gmail, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


moveToTrash()

Sposta il messaggio nel cestino.

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

Invio

GmailMessage: questo messaggio di Gmail, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


refresh()

Ricarica questo messaggio e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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: messaggio per il collegamento.

Autorizzazione

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

  • https://mail.google.com/

reply(body)

Risponde al mittente di questo messaggio utilizzando l'indirizzo per risposte. Le dimensioni dell'email. (incluse le intestazioni) è quota limitata.

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

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.

Invio

GmailMessage : questo messaggio, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


reply(body, options)

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

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

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

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.
optionsObjectUn oggetto JavaScript che specifica parametri avanzati, come elencato di seguito.

Parametri avanzati

NomeTipoDescrizione
attachmentsBlobSource[]un array di file da inviare con l'email
bccStringun elenco di indirizzi email separati da virgole in Ccn
ccStringun elenco di indirizzi email separati da virgole in Cc
fromStringl'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
htmlBodyStringse impostato, i dispositivi in grado di eseguire il rendering dell'HTML lo utilizzano anziché l'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se hai immagini incorporate per le tue email
inlineImagesObjectun oggetto JavaScript contenente un mapping dalla chiave immagine (String) ai dati dell'immagine (BlobSource); presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" />
nameStringil nome del mittente dell'email (impostazione predefinita: nome dell'utente)
noReplyBooleantrue se l'email deve essere inviata da un indirizzo generico indirizzo email no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è possibile solo per gli account Google Workspace, non per gli utenti Gmail.
replyToStringUn indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)
subjectStringUna nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Invio

GmailMessage : questo messaggio, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


replyAll(body)

Risponde al mittente utilizzando l'indirizzo per risposte e a tutti i destinatari del messaggio. Le dimensioni delle email (incluse le intestazioni) è quota limitata.

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

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.

Invio

GmailMessage - Questo messaggio,utile per il collegamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


replyAll(body, options)

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

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

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

Parametri

NomeTipoDescrizione
bodyStringIl corpo dell'email.
optionsObjectUn oggetto JavaScript che specifica parametri avanzati, come elencato di seguito.

Parametri avanzati

NomeTipoDescrizione
attachmentsBlobSource[]un array di file da inviare con l'email
bccStringun elenco di indirizzi email separati da virgole in Ccn
ccStringun elenco di indirizzi email separati da virgole in Cc
fromStringl'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases()
htmlBodyStringse impostato, i dispositivi in grado di eseguire il rendering dell'HTML lo utilizzano anziché l'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se hai immagini incorporate per le tue email
inlineImagesObjectun oggetto JavaScript contenente un mapping dalla chiave immagine (String) ai dati dell'immagine (BlobSource); presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" />
nameStringil nome del mittente dell'email (impostazione predefinita: nome dell'utente)
noReplyBooleantrue se l'email deve essere inviata da un indirizzo generico indirizzo email no-reply per scoraggiare i destinatari dal rispondere alle email; questa opzione è possibile solo per gli account Google Workspace, non per gli utenti Gmail.
replyToStringUn indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)
subjectStringUna nuova riga dell'oggetto per l'email, fino a 250 caratteri.

Invio

GmailMessage : questo messaggio, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


star()

Aggiungi il messaggio a Speciali.

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

Invio

GmailMessage: questo messaggio di Gmail, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche


unstar()

Rimuove il messaggio da Speciali.

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

Invio

GmailMessage: questo messaggio di Gmail, utile per il concatenamento.

Autorizzazione

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

  • https://mail.google.com/

Vedi anche