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 forza l'aggiornamento del thread (GmailThread.refresh() ). |
addToThreads(threads) | GmailLabel | Aggiunge questa etichetta ai thread specificati e ne forza l'aggiornamento. |
deleteLabel() | void | Elimina questa etichetta. |
getName() | String | Restituisce il nome di questa etichetta. |
getThreads() | GmailThread[] | Recupera i thread contrassegnati con questa etichetta. |
getThreads(start, max) | GmailThread[] | Visualizza un intervallo di thread contrassegnati con questa etichetta. |
getUnreadCount() | Integer | Recupera il numero di thread da leggere contrassegnati 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 ne forza l'aggiornamento. |
Documentazione dettagliata
addToThread(thread)
Aggiunge questa etichetta al thread specificato e forza l'aggiornamento del thread (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. |
Ritorni
GmailLabel
: questa etichetta, 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
addToThreads(threads)
Aggiunge questa etichetta ai thread specificati e ne forza l'aggiornamento. Puoi aggiungere etichette per un massimo di 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. |
Ritorni
GmailLabel
: questa etichetta, 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
deleteLabel()
Elimina questa etichetta.
var label = GmailApp.getUserLabelByName("MyLabel"); label.deleteLabel();
Tiri
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 o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getName()
Restituisce il nome di questa etichetta.
var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getName()); //logs MyLabel
Ritorni
String
: il nome dell'etichetta.
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/
getThreads()
Recupera i thread contrassegnati con questa etichetta.
Questa chiamata non riesce quando 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 getThreads(start, max)
e specifica gli intervalli dei 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()); }
Ritorni
GmailThread[]
: un array di thread contrassegnati da questa etichetta.
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/
getThreads(start, max)
Visualizza 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. |
Ritorni
GmailThread[]
: un array di thread contrassegnati da questa etichetta.
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/
getUnreadCount()
Recupera il numero di thread da leggere contrassegnati con questa etichetta.
// log the number of unread threads labeled with MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getUnreadCount());
Ritorni
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 o ambiti appropriati dall'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 | L'etichetta del thread deve essere rimossa. |
Ritorni
GmailLabel
: questa etichetta, 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
removeFromThreads(threads)
Rimuove questa etichetta dai thread specificati e ne forza l'aggiornamento. Puoi rimuovere le etichette 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 non etichettare. |
Ritorni
GmailLabel
: questa etichetta, 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/