Fornisce l'accesso a thread, messaggi ed etichette di Gmail.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
createDraft(recipient, subject, body) | GmailDraft | Crea una bozza di 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 questo account in Gmail. |
getDraft(draftId) | GmailDraft | Recupera la bozza di un messaggio email in base all'ID. |
getDraftMessages() | GmailMessage[] | Recupera tutte le bozze di messaggi. |
getDrafts() | GmailDraft[] | Recupera tutte le bozze di Gmail. |
getInboxThreads() | GmailThread[] | Recupera tutti i thread di Posta in arrivo a prescindere dalle etichette. |
getInboxThreads(start, max) | GmailThread[] | Recupera un intervallo di thread di 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 in base all'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 a prescindere dalle etichette. |
getPriorityInboxThreads(start, max) | GmailThread[] | Recupera un intervallo di thread della Posta prioritaria a prescindere dalle etichette. |
getPriorityInboxUnreadCount() | Integer | Recupera il numero di thread da leggere nella Posta prioritaria. |
getSpamThreads() | GmailThread[] | Recupera tutti i thread di spam a prescindere dalle etichette. |
getSpamThreads(start, max) | GmailThread[] | Recupera una serie di thread di spam a prescindere dalle etichette. |
getSpamUnreadCount() | Integer | Recupera il numero di thread da leggere che sono spam. |
getStarredThreads() | GmailThread[] | Recupera tutti i thread speciali a prescindere dalle etichette. |
getStarredThreads(start, max) | GmailThread[] | Recupera un intervallo di thread speciali a prescindere dalle etichette. |
getStarredUnreadCount() | Integer | Restituisce il numero di thread da leggere che sono stati aggiunti a Speciali. |
getThreadById(id) | GmailThread | Recupera un thread per ID. |
getTrashThreads() | GmailThread[] | Recupera tutti i thread del cestino a prescindere dalle etichette. |
getTrashThreads(start, max) | GmailThread[] | Recupera un intervallo di thread del cestino indipendentemente dalle etichette. |
getUserLabelByName(name) | GmailLabel | Recupera un'etichetta dato il nome dell'etichetta. |
getUserLabels() | GmailLabel[] | Recupera un elenco di etichette create dall'utente. |
markMessageRead(message) | GmailApp | Contrassegna questo messaggio come letto e forza l'aggiornamento del messaggio. |
markMessageUnread(message) | GmailApp | Contrassegna questo messaggio come da leggere e forza l'aggiornamento del messaggio. |
markMessagesRead(messages) | GmailApp | Contrassegna questi messaggi come letti e forza l'aggiornamento dei messaggi. |
markMessagesUnread(messages) | GmailApp | Contrassegna questo messaggio come da leggere e impone l'aggiornamento dei messaggi. |
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 forza l'aggiornamento del thread. |
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 ne forza l'aggiornamento. |
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 ne forza l'aggiornamento. |
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 ne forza l'aggiornamento. |
moveThreadsToInbox(threads) | GmailApp | Sposta questi thread nella Posta in arrivo e forza l'aggiornamento dei thread. |
moveThreadsToSpam(threads) | GmailApp | Sposta questi thread nella cartella Spam e forza l'aggiornamento dei thread. |
moveThreadsToTrash(threads) | GmailApp | Sposta questi thread nel cestino e ne forza l'aggiornamento. |
refreshMessage(message) | GmailApp | Ricarica il messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati). |
refreshMessages(messages) | GmailApp | Ricarica i messaggi e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati). |
refreshThread(thread) | GmailApp | Ricarica il thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati). |
refreshThreads(threads) | GmailApp | Ricarica i thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati). |
search(query) | GmailThread[] | Eseguire una ricerca in Gmail con la query specificata. |
search(query, start, max) | GmailThread[] | Eseguire una ricerca in Gmail con 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 token di accesso ai messaggi corrente 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 ne forza l'aggiornamento. |
unstarMessages(messages) | GmailApp | Rimuove le stelle da questi messaggi e ne forza l'aggiornamento. |
Documentazione dettagliata
createDraft(recipient, subject, body)
Crea una bozza di messaggio email. La dimensione dell'email (incluse le intestazioni) è una quota limitata.
// The code below creates a draft email with the current date and time. var now = new Date(); GmailApp.createDraft("mike@example.com", "current time", "The time is: " + now.toString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
recipient | String | elenco di indirizzi email separati da virgole |
subject | String | oggetto dell'email |
body | String | corpo dell'email |
Ritorni
GmailDraft
: la bozza di Gmail appena creata
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
createDraft(recipient, subject, body, options)
Crea una bozza di messaggio email con argomenti facoltativi. L'email può contenere testo normale o un corpo HTML. La dimensione dell'email (incluse le intestazioni, ma esclusi gli allegati) è una quota limitata.
// Create a draft email with a file from Google Drive attached as a PDF. var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); GmailApp.createDraft('mike@example.com', '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 specifichi 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 separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
from | String | l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da getAliases() |
htmlBody | String | se impostato, i dispositivi in grado di visualizzare il codice HTML lo utilizzeranno al posto dell'argomento corpo richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo 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: il nome dell'utente). |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente) |
Ritorni
GmailDraft
: la bozza di Gmail appena creata
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
GmailLabel
: l'etichetta appena creata
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getAliases()
Recupera un elenco delle email configurate come alias per questo account in Gmail.
Puoi inviare un messaggio da uno qualsiasi di questi alias utilizzando l'argomento facoltativo "from".
// 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.'); }
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getDraft(draftId)
Recupera la bozza di un messaggio email in base all'ID.
Utilizza questa funzione in combinazione con 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 |
Ritorni
GmailDraft
: la bozza con l'ID specificato
Tiri
Error
: se non è possibile trovare una bozza con l'ID specificato
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getDraftMessages()
Recupera tutte le bozze di messaggi.
// Logs the number of draft messages var drafts = GmailApp.getDraftMessages(); Logger.log(drafts.length);
Ritorni
GmailMessage[]
: 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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getDrafts()
Recupera tutte le bozze di Gmail.
var drafts = GmailApp.getDrafts(); for (var i = 0; i < drafts.length; i++) { Logger.log(drafts[i].getId()); }
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getInboxThreads()
Recupera tutti i thread di Posta in arrivo a prescindere dalle etichette.
Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paged" e specifica gli intervalli dei 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()); }
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getInboxThreads(start, max)
Recupera un intervallo di thread di 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 |
Ritorni
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 o ambiti appropriati dall'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());
Ritorni
Integer
: il numero di thread nella Posta in arrivo che contengono messaggi da leggere
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getMessageById(id)
Riceve un messaggio in base all'ID.
Utilizza questa funzione 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 |
Ritorni
GmailMessage
: il messaggio con l'ID specificato
Tiri
Error
: se non è possibile trovare un messaggio con l'ID specificato
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 da recuperare |
Ritorni
GmailMessage[]
: array dei messaggi corrispondenti a questo thread
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 da recuperare |
Ritorni
GmailMessage[][]
: un array di array di messaggi, in cui ogni elemento nell'array esterno corrisponde a un thread e l'array interno contiene i messaggi in quel thread
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getPriorityInboxThreads()
Recupera tutti i thread della Posta prioritaria a prescindere dalle etichette.
Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paged" e specifica gli intervalli dei thread da recuperare in ogni chiamata.
Logger.log("# of messages in your Priority Inbox: " + GmailApp.getPriorityInboxThreads().length);
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getPriorityInboxThreads(start, max)
Recupera un intervallo di thread della Posta prioritaria a prescindere 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 |
Ritorni
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 o ambiti appropriati dall'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());
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getSpamThreads()
Recupera tutti i thread di spam a prescindere dalle etichette.
Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paged" e specifica gli intervalli dei thread da recuperare in ogni chiamata.
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getSpamThreads(start, max)
Recupera una serie di thread di spam a prescindere 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getSpamUnreadCount()
Recupera 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());
Ritorni
Integer
: il numero di thread di spam con messaggi da leggere
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getStarredThreads()
Recupera tutti i thread speciali a prescindere dalle etichette.
Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paged" e specifica gli intervalli dei thread da recuperare in ogni chiamata.
// Logs the number of starred threads Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getStarredThreads(start, max)
Recupera un intervallo di thread speciali a prescindere 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getStarredUnreadCount()
Restituisce il numero di thread da leggere che sono stati aggiunti a Speciali.
Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());
Ritorni
Integer
: il numero di thread speciali con messaggi da leggere
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getThreadById(id)
Recupera un thread per ID.
Utilizza questa funzione in combinazione con 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. |
Ritorni
GmailThread
: il thread con l'ID specificato o null
, se non è stato trovato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getTrashThreads()
Recupera tutti i thread del cestino a prescindere dalle etichette.
Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paged" e specifica gli intervalli dei thread da recuperare in ogni chiamata.
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getTrashThreads(start, max)
Recupera un intervallo 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getUserLabelByName(name)
Recupera un'etichetta dato il nome dell'etichetta.
var labelObject = GmailApp.getUserLabelByName("myLabel");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome dell'etichetta da recuperare |
Ritorni
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 o ambiti appropriati dall'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()); }
Ritorni
GmailLabel[]
: array di etichette create dall'utente
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
markMessageRead(message)
Contrassegna questo 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
markMessageUnread(message)
Contrassegna questo 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
markMessagesRead(messages)
Contrassegna questi messaggi come letti e forza l'aggiornamento dei messaggi.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
markMessagesUnread(messages)
Contrassegna questo messaggio come da leggere e impone l'aggiornamento dei messaggi.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 da contrassegnare come importante |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
markThreadUnimportant(thread)
Contrassegna questo thread come non importante e forza l'aggiornamento del thread.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
markThreadsRead(threads)
Contrassegna questi thread come letti e ne forza l'aggiornamento.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
moveThreadToArchive(thread)
Sposta questo thread nell'archivio e ne forza l'aggiornamento.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
moveThreadsToArchive(threads)
Sposta questi thread nell'archivio e ne forza l'aggiornamento.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
moveThreadsToInbox(threads)
Sposta questi thread nella Posta in arrivo e forza l'aggiornamento dei thread.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
moveThreadsToTrash(threads)
Sposta questi thread nel cestino e ne forza l'aggiornamento.
// 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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
refreshMessage(message)
Ricarica il messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
refreshMessages(messages)
Ricarica i messaggi e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
refreshThread(thread)
Ricarica il thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
refreshThreads(threads)
Ricarica i thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
search(query)
Eseguire una ricerca in Gmail con la query specificata.
Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paged" e specifica gli intervalli dei 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 | alla query di ricerca, così come la digiteresti in Gmail |
Ritorni
GmailThread[]
: un array di thread di Gmail corrispondenti a questa query
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
search(query, start, max)
Eseguire una ricerca in Gmail con 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 | alla query di ricerca, così come la digiteresti in Gmail |
start | Integer | l'indice del thread iniziale |
max | Integer | il numero massimo di thread da restituire |
Ritorni
GmailThread[]
: un array di thread di Gmail corrispondenti a questa query
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
sendEmail(recipient, subject, body)
Invia un messaggio email. La dimensione dell'email (incluse le intestazioni) è una quota limitata.
// The code below will send an email with the current date and time. var now = new Date(); GmailApp.sendEmail("mike@example.com", "current time", "The time is: " + now.toString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
recipient | String | elenco di indirizzi email separati da virgole |
subject | String | oggetto dell'email (massimo 250 caratteri) |
body | String | corpo dell'email |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
sendEmail(recipient, subject, body, options)
Invia un messaggio email con argomenti facoltativi. L'email può contenere testo normale o un corpo HTML. La dimensione dell'email (incluse le intestazioni, ma esclusi gli allegati) è una quota limitata.
// Send an email with a file from Google Drive attached as a PDF. var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); GmailApp.sendEmail('mike@example.com', '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 specifichi 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 separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
from | String | l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da getAliases() |
htmlBody | String | se impostato, i dispositivi in grado di visualizzare il codice HTML lo utilizzeranno al posto dell'argomento corpo richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo 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: il nome dell'utente). |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo email generico non abilitato alle risposte per scoraggiare i destinatari dal rispondere alle email. Questa opzione è disponibile solo per gli account Google Workspace, non per gli utenti di Gmail. |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente) |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
setCurrentMessageAccessToken(accessToken)
Imposta il token di accesso ai messaggi corrente che consente allo script di accedere alle proprietà GmailMessage
correnti.
Solo i progetti di componenti aggiuntivi di Google Workspace che utilizzano gli ambiti dei messaggi attuali di Gmail 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 azione del componente aggiuntivo di Gmail. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
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 |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
unstarMessage(message)
Rimuove il messaggio da Speciali e ne forza l'aggiornamento.
// 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 da rimuovere da Speciali |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
unstarMessages(messages)
Rimuove le stelle 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 da rimuovere da Speciali |
Ritorni
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/