Class GmailApp

GmailApp

Fornisce l'accesso a thread, messaggi ed etichette di Gmail.

Metodi

Metodo	Tipo restituito	Breve descrizione
createDraft(recipient, subject, body)	GmailDraft	Crea la bozza di un messaggio email.
createDraft(recipient, subject, body, options)	GmailDraft	Crea una bozza di messaggio email con argomenti facoltativi.
createLabel(name)	GmailLabel	Crea una nuova etichetta utente con il nome specificato.
deleteLabel(label)	GmailApp	Elimina l'etichetta specificata.
getAliases()	String[]	Recupera un elenco delle email configurate come alias per l'account in Gmail.
getDraft(draftId)	GmailDraft	Recupera la bozza di un'email in base all'ID.
getDraftMessages()	GmailMessage[]	Recupera tutte le bozze dei messaggi.
getDrafts()	GmailDraft[]	Riceve tutte le bozze di Gmail.
getInboxThreads()	GmailThread[]	Recupera tutti i thread della Posta in arrivo, indipendentemente dalle etichette.
getInboxThreads(start, max)	GmailThread[]	Recupera un intervallo di thread della Posta in arrivo indipendentemente dalle etichette.
getInboxUnreadCount()	Integer	Recupera il numero di thread da leggere nella Posta in arrivo.
getMessageById(id)	GmailMessage	Riceve un messaggio tramite ID.
getMessagesForThread(thread)	GmailMessage[]	Recupera tutti i messaggi nel thread specificato.
getMessagesForThreads(threads)	GmailMessage[][]	Recupera tutti i messaggi nei thread specificati.
getPriorityInboxThreads()	GmailThread[]	Recupera tutti i thread della Posta prioritaria indipendentemente dalle etichette.
getPriorityInboxThreads(start, max)	GmailThread[]	Recupera un intervallo di thread della Posta prioritaria, indipendentemente dalle etichette.
getPriorityInboxUnreadCount()	Integer	Recupera il numero di thread da leggere nella Posta prioritaria.
getSpamThreads()	GmailThread[]	Recupera tutti i thread di spam indipendentemente dalle etichette.
getSpamThreads(start, max)	GmailThread[]	Recupera una serie di thread di spam indipendentemente dalle etichette.
getSpamUnreadCount()	Integer	Restituisce il numero di thread da leggere che sono spam.
getStarredThreads()	GmailThread[]	Recupera tutti i thread aggiunti a Speciali indipendentemente dalle etichette.
getStarredThreads(start, max)	GmailThread[]	Recupera un intervallo di thread aggiunti a Speciali indipendentemente dalle etichette.
getStarredUnreadCount()	Integer	Restituisce il numero di thread da leggere aggiunti a Speciali.
getThreadById(id)	GmailThread	Recupera un thread per ID.
getTrashThreads()	GmailThread[]	Recupera tutti i thread del cestino indipendentemente dalle etichette.
getTrashThreads(start, max)	GmailThread[]	Recupera una serie di thread del cestino indipendentemente dalle etichette.
getUserLabelByName(name)	GmailLabel	Recupera un'etichetta data il nome dell'etichetta.
getUserLabels()	GmailLabel[]	Recupera un elenco di etichette create dall'utente.
markMessageRead(message)	GmailApp	Contrassegna il messaggio come letto e forza l'aggiornamento del messaggio.
markMessageUnread(message)	GmailApp	Contrassegna il messaggio come da leggere e forza l'aggiornamento del messaggio.
markMessagesRead(messages)	GmailApp	Contrassegna questi messaggi come letti e ne forza l'aggiornamento.
markMessagesUnread(messages)	GmailApp	Contrassegna questi messaggi come da leggere e ne forza l'aggiornamento.
markThreadImportant(thread)	GmailApp	Contrassegna questo thread come importante e forza l'aggiornamento del thread.
markThreadRead(thread)	GmailApp	Contrassegna questo thread come letto e forza l'aggiornamento del thread.
markThreadUnimportant(thread)	GmailApp	Contrassegna questo thread come non importante e ne forza l'aggiornamento.
markThreadUnread(thread)	GmailApp	Contrassegna questo thread come da leggere e forza l'aggiornamento del thread.
markThreadsImportant(threads)	GmailApp	Contrassegna questi thread come importanti e forza l'aggiornamento dei thread.
markThreadsRead(threads)	GmailApp	Contrassegna questi thread come letti e forza l'aggiornamento dei thread.
markThreadsUnimportant(threads)	GmailApp	Contrassegna questi thread come non importanti e ne forza l'aggiornamento.
markThreadsUnread(threads)	GmailApp	Contrassegna questi thread come da leggere e forza l'aggiornamento dei thread.
moveMessageToTrash(message)	GmailApp	Sposta il messaggio nel cestino e forza l'aggiornamento del messaggio.
moveMessagesToTrash(messages)	GmailApp	Sposta i messaggi specificati nel cestino e forza l'aggiornamento dei messaggi.
moveThreadToArchive(thread)	GmailApp	Sposta questo thread nell'archivio e forza l'aggiornamento del thread.
moveThreadToInbox(thread)	GmailApp	Sposta questo thread nella Posta in arrivo e forza l'aggiornamento del thread.
moveThreadToSpam(thread)	GmailApp	Sposta questo thread nella cartella Spam e forza l'aggiornamento del thread.
moveThreadToTrash(thread)	GmailApp	Sposta questo thread nel cestino e forza l'aggiornamento del thread.
moveThreadsToArchive(threads)	GmailApp	Sposta questi thread nell'archivio e forza l'aggiornamento dei thread.
moveThreadsToInbox(threads)	GmailApp	Sposta questi thread nella Posta in arrivo e ne forza l'aggiornamento.
moveThreadsToSpam(threads)	GmailApp	Sposta questi thread nella cartella Spam e forza l'aggiornamento dei thread.
moveThreadsToTrash(threads)	GmailApp	Sposta questi thread nel cestino e forza l'aggiornamento dei thread.
refreshMessage(message)	GmailApp	Ricarica il messaggio e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).
refreshMessages(messages)	GmailApp	Consente di ricaricare i messaggi e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).
refreshThread(thread)	GmailApp	Consente di ricaricare il thread e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).
refreshThreads(threads)	GmailApp	Ricarica i thread e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).
search(query)	GmailThread[]	Eseguire ricerche in Gmail utilizzando la query specificata.
search(query, start, max)	GmailThread[]	Eseguire ricerche in Gmail utilizzando la query specificata.
sendEmail(recipient, subject, body)	GmailApp	Invia un messaggio email.
sendEmail(recipient, subject, body, options)	GmailApp	Invia un messaggio email con argomenti facoltativi.
setCurrentMessageAccessToken(accessToken)	void	Imposta il messaggio corrente token di accesso che consente allo script di accedere alle proprietà GmailMessage correnti.
starMessage(message)	GmailApp	Aggiunge questo messaggio a Speciali e ne forza l'aggiornamento.
starMessages(messages)	GmailApp	Aggiunge questi messaggi a Speciali e ne forza l'aggiornamento.
unstarMessage(message)	GmailApp	Rimuove il messaggio da Speciali e forza l'aggiornamento del messaggio.
unstarMessages(messages)	GmailApp	Rimuove gli Speciali da questi messaggi e ne forza l'aggiornamento.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
getChatThreads()	GmailThread[]	Riceve tutti i thread della versione classica di Google Hangouts e i thread di Google Chat finché Google non li sostituisce tutti utenti della versione classica di Hangouts a Chat entro la fine dell'anno.
getChatThreads(start, max)	GmailThread[]	Recupera una serie di thread della versione classica di Google Hangouts e di Google Chat fino al passaggio di Google tutti gli utenti della versione classica di Hangouts a Chat entro la fine dell'anno.

Documentazione dettagliata

createDraft(recipient, subject, body)

Crea la bozza di un messaggio email. La dimensione delle email (incluse le intestazioni) è quota limitata.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("[e-mail]", "current time", "The time is: " + now.toString());

Parametri

Nome	Tipo	Descrizione
recipient	String	elenco di indirizzi email separati da virgole
subject	String	l'oggetto dell'email
body	String	corpo dell'email

Invio

GmailDraft: la bozza di Gmail 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

• createDraft(recipient, subject, body, options)

---

createDraft(recipient, subject, body, options)

Crea una bozza di messaggio email con argomenti facoltativi. L'email può contenere testo normale o Corpo HTML. Le dimensioni dell'email (incluse le intestazioni, ma gli allegati esclusi) sono con limitazioni di quota.

// Create a draft email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft('[e-mail]', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parametri

Nome	Tipo	Descrizione
recipient	String	gli indirizzi del destinatario
subject	String	la riga dell'oggetto
body	String	il corpo dell'email
options	Object	un oggetto JavaScript che specifica 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 in Ccn
cc	String	un elenco di indirizzi email separati da virgole in Cc
from	String	l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da getAliases()
htmlBody	String	se impostato, verrà usato dai dispositivi in grado di eseguire il rendering dell'HTML dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel codice HTML corpo se hai immagini incorporate per la tua email
inlineImages	Object	un 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" />
name	String	il nome del mittente dell'email (impostazione predefinita: nome dell'utente)
replyTo	String	Un indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)

Invio

GmailDraft: la bozza di Gmail 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

• createDraft(recipient, subject, body)

---

createLabel(name)

Crea una nuova etichetta utente con il nome specificato.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

Parametri

Nome	Tipo	Descrizione
name	String	il nome della nuova etichetta

Invio

GmailLabel: l'etichetta 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

• deleteLabel(label)

---

deleteLabel(label)

Elimina l'etichetta specificata.

// Have to get the label by name first
var label = GmailApp.getUserLabelByName("FOO");
GmailApp.deleteLabel(label);

Parametri

Nome	Tipo	Descrizione
label	GmailLabel	l'etichetta da eliminare

Invio

GmailApp: il servizio Gmail, 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

• createLabel(name)

---

getAliases()

Recupera un elenco delle email configurate come alias per l'account in Gmail.

Puoi inviare un messaggio da uno qualsiasi di questi alias utilizzando il campo "da" un argomento facoltativo.

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {'from': aliases[0]});
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

Invio

String[]: un array di alias per questo account

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

• sendEmail(recipient, subject, body, options)

---

getDraft(draftId)

Recupera la bozza di un'email in base all'ID.

Da utilizzare insieme a getId() nelle bozze di Gmail.

// Get the first draft message in your drafts folder
var draft = GmailApp.getDrafts()[0];
// Get its ID
var draftId = draft.getId();
// Now fetch the same draft using that ID.
var draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Parametri

Nome	Tipo	Descrizione
draftId	String	l'ID della bozza da recuperare

Invio

GmailDraft: la bozza con l'ID specificato

Lanci

Error: se non è possibile trovare nessuna bozza con l'ID specificato

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/

---

getDraftMessages()

Recupera tutte le bozze dei messaggi.

// Logs the number of draft messages
var drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

Invio

GmailMessage[]: un array di messaggi Gmail in 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/

---

getDrafts()

Riceve tutte le bozze di Gmail.

var drafts = GmailApp.getDrafts();
for (var i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

Invio

GmailDraft[]: un array di bozze di messaggi di Gmail

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/

---

getInboxThreads()

Recupera tutti i thread della Posta in arrivo, indipendentemente dalle etichette.

Questa chiamata non riuscirà quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Quando la dimensione del thread è sconosciuta e potenzialmente molto grande, usa la chiamare e specificare gli intervalli di thread da recuperare in ogni chiamata.

// Log the subject lines of your Inbox
var threads = GmailApp.getInboxThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Invio

GmailThread[]: un array di thread di Gmail 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/

---

getInboxThreads(start, max)

Recupera un intervallo di thread della Posta in arrivo indipendentemente dalle etichette.

// Log the subject lines of up to the first 50 emails in your Inbox
var threads = GmailApp.getInboxThreads(0, 50);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Parametri

Nome	Tipo	Descrizione
start	Integer	l'indice del primo thread da recuperare
max	Integer	il numero massimo di thread da recuperare

Invio

GmailThread[]: un array di thread di Gmail 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/

---

getInboxUnreadCount()

Recupera il numero di thread da leggere nella Posta in arrivo.

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

Invio

Integer: il numero di thread nella Posta in arrivo con messaggi da leggere.

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/

---

getMessageById(id)

Riceve un messaggio tramite ID.

Da utilizzare in combinazione con getId() nei messaggi Gmail.

// Get the first message in the first thread of your inbox
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
var messageId = message.getId();
// Now fetch the same message using that ID.
var messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() == messageById.getSubject());

Parametri

Nome	Tipo	Descrizione
id	String	l'ID del messaggio da recuperare

Invio

GmailMessage: il messaggio con l'ID specificato

Lanci

Error: se non è possibile trovare nessun messaggio con l'ID specificato

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

• getThreadById(id)

---

getMessagesForThread(thread)

Recupera tutti i messaggi nel thread specificato.

// Log all the subject lines in the first thread of your inbox
var thread = GmailApp.getInboxThreads(0, 1)[0];
var messages = GmailApp.getMessagesForThread(thread);
for (var i = 0 ; i < messages.length; i++) {
  Logger.log("subject: " + messages[i].getSubject());
}

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread di messaggi per recuperare

Invio

GmailMessage[]: array di messaggi corrispondenti a questo thread

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

• getMessagesForThreads(threads)

---

getMessagesForThreads(threads)

Recupera tutti i messaggi nei thread specificati.

// Log the subject lines of all messages in the first two threads of your inbox
var thread = GmailApp.getInboxThreads(0, 2);
var messages = GmailApp.getMessagesForThreads(thread);
for (var i = 0 ; i < messages.length; i++) {
  for (var j = 0; j < messages[i].length; j++) {
    Logger.log("subject: " + messages[i][j].getSubject());
  }
}

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	i thread di messaggi per recuperare

Invio

GmailMessage[][]: un array di messaggi, in cui ogni elemento dell'array esterno corrisponde a una e l'array interno contiene i messaggi contenuti in quel thread

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

• getMessagesForThread(thread)

---

getPriorityInboxThreads()

Recupera tutti i thread della Posta prioritaria indipendentemente dalle etichette.

Questa chiamata non riuscirà quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Quando la dimensione del thread è sconosciuta e potenzialmente molto grande, usa la chiamare e specificare gli intervalli di thread da recuperare in ogni chiamata.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

Invio

GmailThread[]: un array di thread di Gmail nella Posta 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/

---

getPriorityInboxThreads(start, max)

Recupera un intervallo di thread della Posta prioritaria, indipendentemente dalle etichette.

// Will log some number 2 or less
Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads(0, 2).length);

Parametri

Nome	Tipo	Descrizione
start	Integer	l'indice del primo thread da recuperare
max	Integer	il numero massimo di thread da recuperare

Invio

GmailThread[]: un array di thread di Gmail nella Posta 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/

---

getPriorityInboxUnreadCount()

Recupera il numero di thread da leggere nella Posta prioritaria.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

Invio

Integer: il numero di thread nella Posta prioritaria che contengono messaggi da leggere.

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/

---

getSpamThreads()

Recupera tutti i thread di spam indipendentemente dalle etichette.

Questa chiamata non riuscirà quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Quando la dimensione del thread è sconosciuta e potenzialmente molto grande, usa la chiamare e specificare gli intervalli di thread da recuperare in ogni chiamata.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

Invio

GmailThread[]: un array di thread di Gmail nella cartella Spam

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/

---

getSpamThreads(start, max)

Recupera una serie di thread di spam indipendentemente dalle etichette.

// Will log a number at most 5
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);

Parametri

Nome	Tipo	Descrizione
start	Integer	l'indice del primo thread da recuperare
max	Integer	il numero massimo di thread da recuperare

Invio

GmailThread[]: un array di thread di Gmail nella cartella Spam

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/

---

getSpamUnreadCount()

Restituisce il numero di thread da leggere che sono spam.

// Unless you actually read stuff in your spam folder, this should be the same as
// the number of messages in your spam folder.
Logger.log("# unread threads that are spam: " + GmailApp.getSpamUnreadCount());

Invio

Integer: il numero di thread spam con messaggi da leggere

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/

---

getStarredThreads()

Recupera tutti i thread aggiunti a Speciali indipendentemente dalle etichette.

Questa chiamata non riuscirà quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Quando la dimensione del thread è sconosciuta e potenzialmente molto grande, usa la chiamare e specificare gli intervalli di thread da recuperare in ogni chiamata.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

Invio

GmailThread[]: un array di thread di Gmail aggiunti a Speciali

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/

---

getStarredThreads(start, max)

Recupera un intervallo di thread aggiunti a Speciali indipendentemente dalle etichette.

// Logs the number of starred threads to a maximum of 5
Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);

Parametri

Nome	Tipo	Descrizione
start	Integer	l'indice del primo thread da recuperare
max	Integer	il numero massimo di thread da recuperare

Invio

GmailThread[]: un array di thread di Gmail aggiunti a Speciali

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/

---

getStarredUnreadCount()

Restituisce il numero di thread da leggere aggiunti a Speciali.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

Invio

Integer: il numero di thread aggiunti a Speciali con messaggi da leggere

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/

---

getThreadById(id)

Recupera un thread per ID.

Da utilizzare insieme a getId() nei thread di Gmail.

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0,1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject());

Parametri

Nome	Tipo	Descrizione
id	String	L'ID del thread da recuperare.

Invio

GmailThread: il thread con l'ID specificato oppure null, se non trovato.

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

• getMessageById(id)

---

getTrashThreads()

Recupera tutti i thread del cestino indipendentemente dalle etichette.

Questa chiamata non riuscirà quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Quando la dimensione del thread è sconosciuta e potenzialmente molto grande, usa la chiamare e specificare gli intervalli di thread da recuperare in ogni chiamata.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

Invio

GmailThread[]: un array di thread di Gmail nel cestino

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/

---

getTrashThreads(start, max)

Recupera una serie di thread del cestino indipendentemente dalle etichette.

// Will log a number at most 5
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);

Parametri

Nome	Tipo	Descrizione
start	Integer	l'indice del primo thread da recuperare
max	Integer	il numero massimo di thread da recuperare

Invio

GmailThread[]: un array di thread di Gmail nel cestino

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/

---

getUserLabelByName(name)

Recupera un'etichetta data il nome dell'etichetta.

var labelObject = GmailApp.getUserLabelByName("myLabel");

Parametri

Nome	Tipo	Descrizione
name	String	il nome dell'etichetta da recuperare

Invio

GmailLabel: l'etichetta di Gmail con il nome specificato

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/

---

getUserLabels()

Recupera un elenco di etichette create dall'utente.

// Logs all of the names of your labels
var labels = GmailApp.getUserLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log("label: " + labels[i].getName());
}

Invio

GmailLabel[]: array di etichette create dall'utente

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/

---

markMessageRead(message)

Contrassegna il messaggio come letto e forza l'aggiornamento del messaggio.

// Mark the first message in the first thread of your inbox as read
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

Parametri

Nome	Tipo	Descrizione
message	GmailMessage	il messaggio da contrassegnare come letto

Invio

GmailApp: il servizio Gmail, 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

• markMessageUnread(message)

---

markMessageUnread(message)

Contrassegna il messaggio come da leggere e forza l'aggiornamento del messaggio.

// Mark the first message in the first thread of your inbox as unread
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

Parametri

Nome	Tipo	Descrizione
message	GmailMessage	il messaggio da contrassegnare come da leggere

Invio

GmailApp: il servizio Gmail, 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

• markMessageRead(message)

---

markMessagesRead(messages)

Contrassegna questi messaggi come letti e ne forza l'aggiornamento.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

Parametri

Nome	Tipo	Descrizione
messages	GmailMessage[]	un array di messaggi da contrassegnare come letti

Invio

GmailApp: il servizio Gmail, 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

• markMessagesUnread(messages)

---

markMessagesUnread(messages)

Contrassegna questi messaggi come da leggere e ne forza l'aggiornamento.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

Parametri

Nome	Tipo	Descrizione
messages	GmailMessage[]	un array di messaggi da contrassegnare come da leggere

Invio

GmailApp: il servizio Gmail, 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

• markMessagesRead(messages)

---

markThreadImportant(thread)

Contrassegna questo thread come importante e forza l'aggiornamento del thread.

// Marks first inbox thread as important
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread per contrassegnare come importante

Invio

GmailApp: il servizio Gmail, 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

• markThreadUnimportant(thread)

---

markThreadRead(thread)

Contrassegna questo thread come letto e forza l'aggiornamento del thread.

// Marks first inbox thread as read
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da contrassegnare come letto

Invio

GmailApp: il servizio Gmail, 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

• markThreadUnread(thread)

---

markThreadUnimportant(thread)

Contrassegna questo thread come non importante e ne forza l'aggiornamento.

// Marks first inbox thread as unimportant
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da contrassegnare come non importante

Invio

GmailApp: il servizio Gmail, 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

• markThreadImportant(thread)

---

markThreadUnread(thread)

Contrassegna questo thread come da leggere e forza l'aggiornamento del thread.

// Marks first inbox thread as unread
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da contrassegnare come da leggere

Invio

GmailApp: il servizio Gmail, 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

• markThreadRead(thread)

---

markThreadsImportant(threads)

Contrassegna questi thread come importanti e forza l'aggiornamento dei thread.

// Marks first two threads in inbox as important
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da contrassegnare come importanti

Invio

GmailApp: il servizio Gmail, 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

• markThreadsUnimportant(threads)

---

markThreadsRead(threads)

Contrassegna questi thread come letti e forza l'aggiornamento dei thread.

// Marks first two threads in inbox as read
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da contrassegnare come letti

Invio

GmailApp: il servizio Gmail, 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

• markThreadsUnread(threads)

---

markThreadsUnimportant(threads)

Contrassegna questi thread come non importanti e ne forza l'aggiornamento.

// Marks first two threads in inbox as unimportant
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da contrassegnare come non importanti

Invio

GmailApp: il servizio Gmail, 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

• markThreadsImportant(threads)

---

markThreadsUnread(threads)

Contrassegna questi thread come da leggere e forza l'aggiornamento dei thread.

// Marks first two threads in inbox as unread
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da contrassegnare come da leggere

Invio

GmailApp: il servizio Gmail, 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

• markThreadsRead(threads)

---

moveMessageToTrash(message)

Sposta il messaggio nel cestino e forza l'aggiornamento del messaggio.

// Move the first message in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

Parametri

Nome	Tipo	Descrizione
message	GmailMessage	il messaggio da spostare nel cestino

Invio

GmailApp: il servizio 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

• moveMessagesToTrash(messages)

---

moveMessagesToTrash(messages)

Sposta i messaggi specificati nel cestino e forza l'aggiornamento dei messaggi.

// Move first two messages in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
var toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

Parametri

Nome	Tipo	Descrizione
messages	GmailMessage[]	i messaggi da spostare nel cestino

Invio

GmailApp: il servizio 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

• moveMessageToTrash(message)

---

moveThreadToArchive(thread)

Sposta questo thread nell'archivio e forza l'aggiornamento del thread.

// Archive the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToArchive(firstThread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da archiviare

Invio

GmailApp: il servizio Gmail, 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

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToTrash(thread)

---

moveThreadToInbox(thread)

Sposta questo thread nella Posta in arrivo e forza l'aggiornamento del thread.

// Find a thread not already in your inbox
var thread = GmailApp.search("-in:inbox")[0]; // Get the first one
GmailApp.moveThreadToInbox(thread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da spostare nella Posta in arrivo

Invio

GmailApp: il servizio Gmail, 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

• moveThreadToTrash(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadToSpam(thread)

Sposta questo thread nella cartella Spam e forza l'aggiornamento del thread.

// Tag first thread in inbox as spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToSpam(firstThread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da spostare nella cartella Spam

Invio

GmailApp: il servizio Gmail, 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

• moveThreadToTrash(thread)
• moveThreadToInbox(thread)
• moveThreadToArchive(thread)

---

moveThreadToTrash(thread)

Sposta questo thread nel cestino e forza l'aggiornamento del thread.

// Move first thread in inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToTrash(firstThread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da spostare nel cestino

Invio

GmailApp: il servizio Gmail, 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

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadsToArchive(threads)

Sposta questi thread nell'archivio e forza l'aggiornamento dei thread.

// Move first two threads in your inbox to the archive
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da archiviare

Invio

GmailApp: il servizio Gmail, 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

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToTrash(threads)

---

moveThreadsToInbox(threads)

Sposta questi thread nella Posta in arrivo e ne forza l'aggiornamento.

// Find two threads not already in your inbox
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da spostare nella posta in arrivo

Invio

GmailApp: il servizio Gmail, 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

• moveThreadsToTrash(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToSpam(threads)

Sposta questi thread nella cartella Spam e forza l'aggiornamento dei thread.

// Move first two threads in your inbox to spam
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da spostare nella cartella Spam

Invio

GmailApp: il servizio Gmail, 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

• moveThreadsToInbox(threads)
• moveThreadsToTrash(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToTrash(threads)

Sposta questi thread nel cestino e forza l'aggiornamento dei thread.

// Move first two threads in your inbox to trash
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	un array di thread da spostare nel cestino

Invio

GmailApp: il servizio Gmail, 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

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

refreshMessage(message)

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

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

Parametri

Nome	Tipo	Descrizione
message	GmailMessage	il messaggio da aggiornare

Invio

GmailApp: il servizio Gmail, 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

• refreshMessages(messages)

---

refreshMessages(messages)

Consente di ricaricare i messaggi e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

Parametri

Nome	Tipo	Descrizione
messages	GmailMessage[]	i messaggi da aggiornare

Invio

GmailApp: il servizio Gmail, 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

• refreshMessage(message)

---

refreshThread(thread)

Consente di ricaricare il thread e lo stato associato da Gmail (utile se le etichette, lo stato di lettura, e così via).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	il thread da aggiornare

Invio

GmailApp: il servizio Gmail, 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

• refreshThreads(threads)

---

refreshThreads(threads)

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

var threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	i thread da aggiornare

Invio

GmailApp: il servizio Gmail, 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

• refreshThread(thread)

---

search(query)

Eseguire ricerche in Gmail utilizzando la query specificata.

Questa chiamata non riuscirà quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Quando la dimensione del thread è sconosciuta e potenzialmente molto grande, usa la chiamare e specificare gli intervalli di thread da recuperare in ogni chiamata.

// Find starred messages with subject IMPORTANT
var threads = GmailApp.search('is:starred subject:"IMPORTANT"');

Parametri

Nome	Tipo	Descrizione
query	String	la query di ricerca, come la digiteresti in Gmail

Invio

GmailThread[]: un array di thread di Gmail che corrispondono a questa query

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/

---

search(query, start, max)

Eseguire ricerche in Gmail utilizzando la query specificata.

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty array.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Parametri

Nome	Tipo	Descrizione
query	String	la query di ricerca, come la digiteresti in Gmail
start	Integer	l'indice del thread iniziale
max	Integer	il numero massimo di thread da restituire

Invio

GmailThread[]: un array di thread di Gmail che corrispondono a questa query

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/

---

sendEmail(recipient, subject, body)

Invia un messaggio email. La dimensione delle email (incluse le intestazioni) è quota limitata.

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("[e-mail]", "current time", "The time is: " + now.toString());

Parametri

Nome	Tipo	Descrizione
recipient	String	elenco di indirizzi email separati da virgole
subject	String	oggetto dell'email (massimo 250 caratteri)
body	String	corpo dell'email

Invio

GmailApp: il servizio Gmail, 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

• sendEmail(recipient, subject, body, options)

---

sendEmail(recipient, subject, body, options)

Invia un messaggio email con argomenti facoltativi. L'email può contenere testo normale o HTML del testo. Le dimensioni dell'email (incluse le intestazioni, ma gli allegati esclusi) sono con limitazioni di quota.

// Send an email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail('[e-mail]', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parametri

Nome	Tipo	Descrizione
recipient	String	gli indirizzi del destinatario
subject	String	la riga dell'oggetto (massimo 250 caratteri)
body	String	il corpo dell'email
options	Object	un oggetto JavaScript che specifica 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 in Ccn
cc	String	un elenco di indirizzi email separati da virgole in Cc
from	String	l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da getAliases()
htmlBody	String	se impostato, verrà usato dai dispositivi in grado di eseguire il rendering dell'HTML dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel codice HTML corpo se hai immagini incorporate per la tua email
inlineImages	Object	un 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" />
name	String	il nome del mittente dell'email (impostazione predefinita: nome dell'utente)
noReply	Boolean	true 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.
replyTo	String	Un indirizzo email da utilizzare come indirizzo predefinito per le risposte (predefinito: l'indirizzo email dell'utente)

Invio

GmailApp: il servizio Gmail, 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

• sendEmail(recipient, subject, body)

---

setCurrentMessageAccessToken(accessToken)

Imposta il messaggio corrente token di accesso che consente allo script di accedere alle proprietà GmailMessage correnti.

Solo i progetti del componente aggiuntivo di Google Workspace che utilizzano gli ambiti dei messaggi attuali di Gmail che richiedono questo metodo.

function handleAddonActionEvent(e) {
  var accessToken = e.messageMetadata.accessToken;
  var messageId = e.messageMetadata.messageId;
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  // Do something with mailMessage
}

Parametri

Nome	Tipo	Descrizione
accessToken	String	Il token di accesso temporaneo ottenuto da un oggetto evento di azione del componente aggiuntivo di Gmail.

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/

---

starMessage(message)

Aggiunge questo messaggio a Speciali e ne forza l'aggiornamento.

// Stars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

Parametri

Nome	Tipo	Descrizione
message	GmailMessage	il messaggio da aggiungere a Speciali

Invio

GmailApp: il servizio Gmail, 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

• starMessages(messages)

---

starMessages(messages)

Aggiunge questi messaggi a Speciali e ne forza l'aggiornamento.

// Stars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

Parametri

Nome	Tipo	Descrizione
messages	GmailMessage[]	un array di messaggi da aggiungere a Speciali

Invio

GmailApp: il servizio Gmail, 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

• starMessage(message)

---

unstarMessage(message)

Rimuove il messaggio da Speciali e forza l'aggiornamento del messaggio.

// Unstars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

Parametri

Nome	Tipo	Descrizione
message	GmailMessage	il messaggio per rimuovere da Speciali

Invio

GmailApp: il servizio Gmail, 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

• unstarMessages(messages)

---

unstarMessages(messages)

Rimuove gli Speciali da questi messaggi e ne forza l'aggiornamento.

// Unstars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

Parametri

Nome	Tipo	Descrizione
messages	GmailMessage[]	un array di messaggi per rimuovere da Speciali

Invio

GmailApp: il servizio Gmail, 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

• unstarMessage(message)

Metodi deprecati

getChatThreads()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Riceve tutti i thread della versione classica di Google Hangouts e i thread di Google Chat finché Google non li sostituisce tutti utenti della versione classica di Hangouts a Chat entro la fine dell'anno. Per saperne di più, consulta Scopri di più sul passaggio dalla versione classica di Hangouts a Google Chat.

Questa chiamata non va a buon fine quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Dove la dimensione del thread è sconosciuta e potenzialmente molto grande, usa la e specificare di thread da recuperare in ogni chiamata.

var threads = GmailApp.getChatThreads();
Logger.log("# of chat threads: " + threads.length);

Invio

GmailThread[]: un array di thread della chat da Gmail.

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/

---

getChatThreads(start, max)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Recupera una serie di thread della versione classica di Google Hangouts e di Google Chat fino al passaggio di Google tutti gli utenti della versione classica di Hangouts a Chat entro la fine dell'anno. Per saperne di più, consulta Scopri di più sul passaggio dalla versione classica di Hangouts a Google Chat.

// Get first 50 chat threads
var threads = GmailApp.getChatThreads(0,50);
// Will log no more than 50.0
Logger.log(threads.length);
Logger.log(threads[0].getFirstMessageSubject());

Parametri

Nome	Tipo	Descrizione
start	Integer	l'indice del primo thread da recuperare
max	Integer	il numero massimo di thread da recuperare

Invio

GmailThread[]: un array di thread di chat di Gmail

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/