Un'etichetta creata dall'utente nell'account Gmail di un utente.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addToThread(thread) | GmailLabel | Aggiunge questa etichetta al thread specificato e ne forza l'aggiornamento (GmailThread.refresh() ). |
addToThreads(threads) | GmailLabel | Aggiunge questa etichetta ai thread specificati e ne forza l'aggiornamento. |
deleteLabel() | void | Elimina questa etichetta. |
getName() | String | Recupera il nome di questa etichetta. |
getThreads() | GmailThread[] | Restituisce i thread contrassegnati con questa etichetta. |
getThreads(start, max) | GmailThread[] | Recupera un intervallo di thread contrassegnati con questa etichetta. |
getUnreadCount() | Integer | Restituisce il numero di thread da leggere taggati con questa etichetta. |
removeFromThread(thread) | GmailLabel | Rimuove questa etichetta dal thread specificato e forza l'aggiornamento del thread. |
removeFromThreads(threads) | GmailLabel | Rimuove questa etichetta dai thread specificati e forza l'aggiornamento dei thread. |
Documentazione dettagliata
addToThread(thread)
Aggiunge questa etichetta al thread specificato e ne forza l'aggiornamento (GmailThread.refresh()
).
// label the first thread in the inbox with the label MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var firstThread = GmailApp.getInboxThreads(0,1)[0]; label.addToThread(firstThread);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
thread | GmailThread | Il thread da etichettare. |
Invio
GmailLabel
: questa etichetta, 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
addToThreads(threads)
Aggiunge questa etichetta ai thread specificati e ne forza l'aggiornamento. Puoi aggiungere etichette per e possono contenere fino a 100 thread per batch.
// label the first three threads in the inbox with the label MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var threads = GmailApp.getInboxThreads(0,3); label.addToThreads(threads);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
threads | GmailThread[] | Un array di thread da etichettare. |
Invio
GmailLabel
: questa etichetta, 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
deleteLabel()
Elimina questa etichetta.
var label = GmailApp.getUserLabelByName("MyLabel"); label.deleteLabel();
Lanci
Error
: se l'etichetta non può essere eliminata
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
getName()
Recupera il nome di questa etichetta.
var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getName()); //logs MyLabel
Invio
String
: il nome dell'etichetta.
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/
getThreads()
Restituisce i thread contrassegnati con questa etichetta.
Questa chiamata non riesce 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 getThreads(start, max)
e specifica gli intervalli di thread da recuperare in ogni chiamata.
// Log the subject lines of the threads labeled with MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var threads = label.getThreads(); for (var i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
Invio
GmailThread[]
: un array di thread contrassegnati con questa etichetta.
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/
getThreads(start, max)
Recupera un intervallo di thread contrassegnati con questa etichetta.
// log the subject lines of up to the first 30 threads with the label MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var threads = label.getThreads(0, 30); for (var i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | L'indice del thread iniziale. |
max | Integer | Il numero massimo di thread da restituire. |
Invio
GmailThread[]
: un array di thread contrassegnati con questa etichetta.
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/
getUnreadCount()
Restituisce il numero di thread da leggere taggati con questa etichetta.
// log the number of unread threads labeled with MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getUnreadCount());
Invio
Integer
: il numero di thread etichettati 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/
removeFromThread(thread)
Rimuove questa etichetta dal thread specificato e forza l'aggiornamento del thread.
// remove the label MyLabel from the first thread in the inbox var label = GmailApp.getUserLabelByName("MyLabel"); var firstThread = GmailApp.getInboxThreads(0,1)[0]; label.removeFromThread(firstThread);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
thread | GmailThread | Il thread deve essere privo di etichetta. |
Invio
GmailLabel
: questa etichetta, 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
removeFromThreads(threads)
Rimuove questa etichetta dai thread specificati e forza l'aggiornamento dei thread. Puoi rimuovere per un massimo di 100 thread per batch.
// remove the label MyLabel from the first three threads in the inbox var label = GmailApp.getUserLabelByName("MyLabel"); var threads = GmailApp.getInboxThreads(0,3); label.removeFromThreads(threads);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
threads | GmailThread[] | Un array di thread da rimuovere dall'etichetta. |
Invio
GmailLabel
: questa etichetta, 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/